Upsun Quick start guide

sites/friday/.yaml

@@ -14,6 +14,7 @@ chrome-headless:
   versions:
     deprecated: []
     supported:
+      - '120'
       - '113'
       - '95'
       - '91'
@@ -163,14 +164,14 @@ elixir:
   type: elixir
   versions:
     deprecated:
+      - '1.13'
+      - '1.12'
       - '1.11'
       - '1.10'
       - '1.9'
     supported:
       - '1.15'
       - '1.14'
-      - '1.13'
-      - '1.12'
     legacy:
       - '1.10'
       - '1.9'
@@ -260,12 +261,13 @@ java:
   type: java
   versions:
     deprecated:
-      - '19'
-      - '18'
       - '14'
       - '13'
       - '12'
     supported:
+      - '21'
+      - '19'
+      - '18'
       - '17'
       - '11'
       - '8'
@@ -354,15 +356,16 @@ mariadb:
     deprecated:
       - '10.2'
       - '10.1'
+      - '10.3'
       - '10.0'
       - '5.5'
     supported:
+      - '11.2'
       - '11.0'
       - '10.11'
       - '10.6'
       - '10.5'
       - '10.4'
-      - '10.3'
   versions-dedicated-gen-2:
     supported:
       - 10.8 Galera
@@ -451,7 +454,7 @@ memcached:
       - '1.4'
   versions-dedicated-gen-2:
     supported:
-      - '1.4'
+      - 1.4*
 mongodb:
   description: Experimental MongoDB support on Platform.sh
   repo_name: mongodb
@@ -509,7 +512,7 @@ network-storage:
   disk: true
   docs:
     relationship_name: 'null'
-    service_name: files
+    service_name: network-storage
     url: /add-services/network-storage.html
   endpoint: something
   min_disk_size: null
@@ -653,6 +656,7 @@ php:
       - '7.0'
   versions:
     deprecated:
+      - '8.0'
       - '7.4'
       - '7.3'
       - '7.2'
@@ -662,9 +666,9 @@ php:
       - '5.5'
       - '5.4'
     supported:
+      - '8.3'
       - '8.2'
       - '8.1'
-      - '8.0'
 postgresql:
   description: PostgreSQL service for Platform.sh.
   repo_name: postgresql
@@ -680,34 +684,36 @@ postgresql:
   type: postgresql
   versions:
     deprecated:
+      - '11'
       - '10'
       - '9.6'
       - '9.5'
       - '9.4'
       - '9.3'
     supported:
+      - '16'
       - '15'
       - '14'
       - '13'
       - '12'
-      - '11'
   versions-dedicated-gen-2:
     deprecated:
+      - 11*
       - 9.6*
       - '9.5'
       - '9.4'
       - '9.3'
-    supported:
-      - 11*
+    supported: []
   versions-dedicated-gen-3:
     deprecated:
+      - '11'
       - '10'
     supported:
+      - '16'
       - '15'
       - '14'
       - '13'
       - '12'
-      - '11'
 python:
   description: ''
   repo_name: python
@@ -738,6 +744,7 @@ python:
       - '3.5'
       - 2.7*
     supported:
+      - '3.12'
       - '3.11'
       - '3.10'
       - '3.9'
@@ -808,6 +815,7 @@ redis:
       - '3.0'
       - '2.8'
     supported:
+      - '7.2'
       - '7.0'
       - '6.2'
     legacy:
@@ -829,6 +837,7 @@ redis:
       - '3.0'
       - '2.8'
     supported:
+      - '7.2'
       - '7.0'
       - '6.2'
 ruby:
@@ -870,6 +879,7 @@ ruby:
       - '2.4'
       - '2.3'
     supported:
+      - '3.3'
       - '3.2'
       - '3.1'
       - '3.0'
@@ -969,6 +979,7 @@ varnish:
       - '7.1'
       - '6.0'
     supported:
+      - '7.3'
       - '7.2'
       - '6.3'
 vault-kms:
@@ -1030,6 +1041,7 @@ redis-persistent:
       - '3.0'
       - '2.8'
     supported:
+      - '7.2'
       - '7.0'
       - '6.2'
     legacy:
@@ -1051,5 +1063,6 @@ redis-persistent:
       - '3.0'
       - '2.8'
     supported:
+      - '7.2'
       - '7.0'
       - '6.2'

sites/friday/config/_default/params.yaml

@@ -79,6 +79,10 @@ _404:
   issues: "https://github.com/platformsh/platformsh-docs/issues/new"
 
 navSections:
+  start:
+    title: Git started
+    section: start
+    weight: -130
   get-started:
     title: Get started
     section: get-started

sites/friday/src/get-started/_index.md

@@ -1,5 +1,5 @@
 ---
-title: Get started
+title: "[TO BE REMOVED] Get started"
 aliases:
 - /get-started/_index.md
----
+---

sites/friday/src/get-started/express/_index.md

@@ -1,5 +1,5 @@
 ---
-title: Express
+title: (REMOVE) Express
 description:   Welcome to our quick-start guide on hosting [Express](https://expressjs.com/) on {{< vendor/name >}} where we will demonstrate just how simple it is to host your [Express](https://expressjs.com/) projects on our PaaS. Follow the steps detailed below and you’ll have everything set up in no time.
 ---
 

sites/friday/src/get-started/nextjs/_index.md

@@ -1,5 +1,5 @@
 ---
-title: Next.js
+title: (REMOVE) Next.js
 description:   Welcome to our quick-start guide on hosting [Next.js](https://nextjs.org/) on {{< vendor/name >}}, where we will demonstrate just how simple it is to host your [Next.js](https://nextjs.org/) projects on our PaaS. Follow the steps detailed below and you’ll have everything set up in no time.
 ---
 

sites/friday/src/get-started/nextjs/local.md

@@ -1,5 +1,5 @@
 ---
-title: "Local development"
+title: "(REMOVE) Local development"
 weight: -120
 description: |
   Once Your Next.js application has been deployed on {{% vendor/name %}}, you might want to start developing your application locally.

sites/friday/src/get-started/quick-start/_index.md

@@ -0,0 +1,103 @@
+---
+title: Quick Start
+weight: -100
+description:   Welcome to our quick-start guide on hosting any stacks on {{< vendor/name >}} where we will demonstrate just how simple it is to host your projects on our PaaS. Follow the steps detailed below and you’ll have everything set up in no time.
+---
+
+{{% description %}}
+
+If you're trying to host a Django, a Laravel, or a Flask stack, please follow corresponding guide:
+
+- [Django Getting started guide](../django/_index.md)
+- [Laravel Getting started guide](../laravel/_index.md)
+- [Flask Getting started guide](../flask/_index.md)
+- or your other favorite stack guide?
+
+{{% guides/link-philosophy %}}
+
+{{< note title=”Tip” >}}
+To get your project up and running as quickly as possible, experiment with the [{{% vendor/name %}} demo app](https://console.upsun.com/projects/create-project/demo) before following this guide.
+{{< /note >}}
+
+{{% guides/requirements name="Stacks" %}}
+
+## Create your local app
+
+First things first, if you don’t have a local project, you need one. So please create your project locally by following the official guide of your choice.
+
+Examples:
+- [Express installation guide](https://expressjs.com/en/starter/installing.html)
+- [Next.js installation guide](https://nextjs.org/docs/getting-started/installation)
+- [Strapi installation guide](https://docs.strapi.io/dev-docs/installation)
+
+
+## Initialize your Git repository
+
+We need to initialize the local Git repository and commit local files, using the following command:
+
+```bash {location="Terminal"}
+git init
+git add .
+git commit -m "Init my application"
+```
+
+[//]: # (TODO see how to make this codetabs looks like a note section with multiple tabs)
+{{< codetabs >}}
++++
+title=Tips for Node.js
++++
+If you're running a Node.js stack, you should also ignore adding ``node_modules`` folder (and any other unwanted folders in your Git repository) to the Git repository by using the following commands:
+```bash {location="Terminal"}
+echo "/node_modules" >> .gitignore
+git add .gitignore && git commit -m "adding node_modules folder in .gitignore file"
+```
+
+<--->
++++
+title=Tips for PHP
++++
+If you're running a PHP stack with composer as dependency manager, you should also ignore adding ``vendor`` folder (and any other unwanted folders in your Git repository) to the Git repository by using the following commands:
+```bash {location="Terminal"}
+echo "/vendor" >> .gitignore
+git add .gitignore && git commit -m "adding vendor folder in .gitignore file"
+```
+{{< /codetabs >}}
+
+[//]: # (TODO rework this part as GH integration could not be part of the quickstart guide)
+## Choose your Git workflow
+
+{{% vendor/name %}} projects can be used as a classic Git repository where you will be able to push your source code in different ways, using either the Git CLI or the {{% vendor/name %}} CLI. You can choose which way—or Git workflow— you would like to use for your project from the following options:
+
+- Your project source code will be **hosted on a {{% vendor/name %}} Git repository**
+- Your project source code will be **hosted on your own GitHub repository**
+
+{{< codetabs >}}
++++
+title={{% vendor/name %}} Git repository
++++
+For the rest of this guide, you will use the normal Git workflow (`git add . && git commit -m "message" && git push {{% vendor/cli %}}`) to commit your source code changes to Git history, and use the {{% vendor/name %}} CLI to deploy your [{{% vendor/name %}} environment](/environments.html) with the latest code updates.
+
+<--->
++++
+title=GitHub repository
++++
+{{% vendor/name %}} provides a feature called [Github integration](integrations/source/github.md) that allows your {{% vendor/name %}} project to be fully integrated with your Github repository.
+This enables you, as a developer, to use a normal Git workflow (`git add . && git commit -m "message" && git push`) to deploy your environment—with no need to connect to the {{% vendor/name %}} Console.
+
+{{< note >}}
+Please make sure you that you have already completed the following steps before adding a [Github integration](integrations/source/github.md):
+
+1. Create a Git repository in your own organization following the relevant [Github repository creation guide](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository).
+2. Create a [Github integration](integrations/source/github.md).
+3. Add a Git remote to your local project, from the root of your project, by inputting the following:
+
+    ```bash {location="Terminal"}
+    git remote add origin <urlOfYourOwnGitHubRepo>
+    git add . && git commit -m "init my app"
+    git push origin
+    ```
+{{< /note >}}
+
+{{< /codetabs >}}
+
+## Next steps