Guides reorganization for initial IA + vendorization

.platform/routes.yaml

@@ -247,6 +247,11 @@ https://{default}/:
       # Sponsored sites application
       "/administration/pricing/sponsored.html": { "to": "/administration/pricing#sponsored-sites", "code": 301 }
 
+      # Overview, tutorials, and best-practices redirects (Aug 2023)
+      "^/bestpractices(.*)":  { "to": "/learn/bestpractices$1", "code": 301, "regexp": true }
+      "^/tutorials(.*)":  { "to": "/learn/tutorials$1", "code": 301, "regexp": true }
+      "^/overview(.*)":  { "to": "/learn/overview$1", "code": 301, "regexp": true }
+
 "https://search.{default}/":
     type: upstream
     upstream: "search:http"

sites/friday/config/_default/config.yaml

@@ -54,7 +54,6 @@ module:
           target: "content"
           excludeFiles: 
               - "registry/*"
-              - "_index.md"
               - "get-started/*"
           lang: "en"
 

sites/friday/config/_default/params.yaml

@@ -66,21 +66,30 @@ _404:
   image: "/images/404/404-8.png"
   issues: "https://github.com/platformsh/platformsh-docs/issues/new"
 
-# Sections in the navigation sidebar
 navSections:
-  home:
-    title: Guides and reference
-    section: home
-    weight: -120
   get-started:
     title: Get started
     section: get-started
+    weight: -120
+  learn:
+    title: Learn
+    section: learn
     weight: -110
   guides:
-    title: Stacks
+    title: Frameworks
     section: guides
     weight: -100
+  home:
+    title: Reference
+    section: home
+    weight: -90
 
+nonDocsSections:
+  apidocs:
+    title: API Documentation
+    link: https://api.platform.sh/docs
+    weight: -80
+
 # Metadata
 meta:
   sitename: "Deploy Friday User Documentation"

sites/friday/layouts/shortcodes/home.html

@@ -1,60 +1,22 @@
-<div class="home-hero" style="text-align: center; padding: 5rem 2rem;">
+<div class="home-hero" style="text-align: center; padding: 4rem 2rem 4rem 2rem;">
 
     <h3>Welcome to the</h3>
-    <h1>{{ .Site.Params.vendor.name }} Developer Center</h1>
+    <h1>{{ .Site.Title }}</h1>
 
-    <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer dictum mauris id tincidunt gravida. Suspendisse sagittis euismod mi. Aliquam erat volutpat. Donec venenatis quam non nisi molestie malesuada.</p>
-    <p>Nam egestas eros vitae orci cursus tincidunt. Duis vel sodales nulla. </p>
+    <p>Built for developers, by developers. The efficient, reliable, and secure Platform-as-a-Service (PaaS) that gives development teams control and peace of mind while accelerating the time it takes to build and deploy applications.</p>
+
+    <p>Resources to help you customize, experiment, and optimize all from one platform.</p>
 
     <div style="margin-top: 3rem;">
         <a class="start-cta font-semibold text-sm xl:text-base px-4 py-2 bg-skye rounded text-white hover:bg-skye-dark focus:bg-skye-dark"
         href="/get-started.html" rel="noopener">Get started</a>
         <a class="info-cta font-semibold text-sm xl:text-base px-4 py-2 bg-skye rounded text-white hover:bg-skye-dark focus:bg-skye-dark"
-        href="/#{{ printf "What is %s?" .Site.Params.vendor.name | anchorize }}" rel="noopener">What is {{ .Site.Params.vendor.name }}?</a>
+        href="/learn/overview.html" rel="noopener">What is {{ .Site.Params.vendor.name }}?</a>
     </div>
 
 
 </div>
 
-<div class="home-resources">
-    <h2>Join our community and navigate developer resources</h2>
-    <table class="tg">
-        <thead>
-          <tr>
-            <th class="tg-0lax">Configuration</th>
-            <th class="tg-0lax">Community</th>
-            <th class="tg-0lax">Topics</th>
-          </tr>
-        </thead>
-        <tbody>
-          <tr>
-            <td class="tg-0lax">
-                <ul class="resource-list">
-                    <li><a href="/create-apps.html">Applications</a></li>
-                    <li><a href="/define-routes.html">Routes</a></li>
-                    <li><a href="/add-services.html">Services</a></li>
-                </ul>
-            </td>
-            <td class="tg-0lax">
-                <ul class="resource-list">
-                    <li><a href="#">Discord</a></li>
-                    <li><a href="#">Forum</a></li>
-                    <li><a href="/overview/get-support.html">Get support</a></li>
-                </ul>
-            </td>
-            <td class="tg-0lax">
-                <ul class="resource-list">
-                    <li><a href="/administration.html">Administration</a></li>
-                    <li><a href="/integrations.html">Integrations</a></li>
-                    <li><a href="/increase-observability.html">Observability</a></li>
-                </ul>
-            </td>
-          </tr>
-        </tbody>
-    </table>
-</div>
-
-
 <style>
     .home-resources {
         text-align: center; 
@@ -74,19 +36,24 @@ <h2>Join our community and navigate developer resources</h2>
     }
 
     .start-cta {
-        color: white !important;
+        /* color: white !important; */
+        color: #191C1E !important;
         text-decoration: none !important;
         font-size: 16px !important;
         font-weight: 700 !important;
         letter-spacing: 0.48px !important;
-        background: #6046FF !important;
+        /* background: #6046FF !important; */
+        background: #FFBDBB!important;
         padding: 10px 16px !important;
         margin-right: 1rem;
-        border-radius: 80px !important;
+        border-radius: 0px !important;
+        /* border-radius: 80px !important; */
     }
     .start-cta:hover {
-        background: #4D38CC !important;
-        color: white !important;
+        /* background: #4D38CC !important; */
+        background: #FF9F9F !important;
+        color: #191C1E !important;
+        /* color: white !important; */
     }
 
     .info-cta {
@@ -97,7 +64,8 @@ <h2>Join our community and navigate developer resources</h2>
         letter-spacing: 0.48px !important;
         background: white !important;
         padding: 10px 16px !important;
-        border-radius: 80px !important;
+        /* border-radius: 80px !important; */
+        border-radius: 0px !important;
         border: 2px solid #191C1E;
         border-color: #191C1E !important;
     }

sites/platform/config/_default/config.yaml

@@ -1,6 +1,6 @@
 # Basics
 baseURL: /
-title: Platform.sh Docs
+title: Platform.sh Documentation
 author: Platform.sh
 description: Platform.sh User Documentation
 

sites/platform/config/_default/params.yaml

@@ -36,7 +36,7 @@ vendor:
 
 # Images (kept in static/)
 logo: "images/logos/Platformsh_logo_white.svg"
-logolinksto: "https://platform.sh"
+logolinksto: "/"
 logoAlt: "Platform.sh"
 favicon: "images/logos/favicon.ico"
 
@@ -65,18 +65,32 @@ _404:
 
 # Sections in the navigation sidebar
 navSections:
-  home:
-    title: Guides and reference
-    section: home
-    weight: -120
   get-started:
     title: Get started
     section: get-started
+    weight: -120
+  learn:
+    title: Learn
+    section: learn
     weight: -110
   guides:
-    title: Stacks
+    title: Frameworks
     section: guides
     weight: -100
+  home:
+    title: Reference
+    section: home
+    weight: -90
+
+nonDocsSections:
+  apidocs:
+    title: API Documentation
+    link: https://api.platform.sh/docs
+    weight: -80
+  # community:
+  #   title: Community Forum
+  #   link: https://community.platform.sh
+  #   weight: -70
 
 # Metadata
 meta:

sites/platform/src/_index.md

@@ -1,47 +1,116 @@
 ---
 title: Introduction
+showTitle: false
+editPage: false
+feedback: false
 ---
 
-{{< vendor/name >}} is a second-generation Platform-as-a-Service built especially for continuous deployment.
-It allows you to host web applications on the cloud while making your development and testing workflows more productive.
+{{< home >}}
 
-If you're new to {{< vendor/name >}}, we recommend starting with the **Big Picture**, in particular [Structure](/overview/structure.md), and [Build & Deploy](/overview/build-deploy.md) will get you started on the right track to best use {{< vendor/name >}}.
+## How the docs are organized
 
-The main requirement of {{< vendor/name >}} is that you use Git to manage your application code.
-Your project's configuration is driven almost entirely by a small number of YAML files in your Git repository.
-The **Configuration** section covers those in more detail and can serve as both a tutorial and a quick reference.
+There are different [kinds](https://documentation.divio.com/) of documentation.
+Some docs are useful when you're just starting out, 
+while others go into detail that's relevant only after you've deployed many projects on {{< vendor/name >}}.
 
-{{< vendor/name >}} is built on Debian, supports many different programming **Languages** and environments,
-and features recommended optimizations for several **Featured Frameworks**.
+This site is roughly split into categories based on where you are in your journey working with {{< vendor/name >}}, described below.
 
-Finally, you can also get tips for setting up your own **Development** workflow and **Administering** your {{< vendor/name >}} account.
+### Get started
 
-## Git Driven Infrastructure
+If you're still unfamiliar with {{< vendor/name >}} and how it works, _but_ you're also looking to quickly start working with the platform, the **Get started** section is the right place to begin.
 
-As a Platform as a Service, or PaaS, {{< vendor/name >}} automatically manages everything your application needs to run.
-That means you can, and should, view your infrastructure needs as part of your application and address them under version control.
+Learn the basics of how {{< vendor/name >}} leverages Git to produce reusable build images, identical-to-production environments in staging and development (including production data), as well as the basics of monitoring and troubleshooting your environments. 
 
-### Infrastructure as code
+Ready to get started? [Let's go!](/get-started/)
 
-{{< vendor/name >}} covers not only all of your hosting needs but also most of your DevOps needs. It is a single tool that covers the application life-cycle from development to production and scaling.
+### Learn
 
-You only need to write your code, including a few YAML files that specify your desired infrastructure, commit it to Git, and push.
-You don't need to set up anything manually. The web server is already set up and configured, as is any database, search engine, or cache that you specify.
+After going through the **Get started** section, you may want to know more about how {{< vendor/name >}} works and the logic behind it. The **[Learn](/learn/_index.md)** section is a collection of tutorials and conceptual guides to help you understand the ins and outs of {{< vendor/name >}}.
 
-Every branch you push can be made a fully independent environment&mdash;complete with your application code, a copy of your database, a copy of your search index, a copy of your user files, everything.
-Its automatically generated URL can be sent to stakeholders or automated CI systems.
-It really is "what would my site look like if I merged this to production?" every time.
+- [**What is {{% vendor/name %}}?**](/learn/overview/_index.md)
 
-You can use these concepts to replicate a traditional development/staging/production workflow or even to give every feature its own effective staging environment before merging to production (empowering you to use git-flow like methodologies even better). You could also have an intermediary integration branch for several other branches.
+    With this guide, find out which problem {{< vendor/name >}} is trying to solve.
+    Learn how {{< vendor/name >}}'s configuration, build and deploy pipelines, and the structure of environments play into the broader philosophy behind reliably deploying applications.
 
-{{< vendor/name >}} respects the structure of branches. It's entirely up to you.
+- [**Tutorials**](/learn/tutorials/_index.md)
 
-### Full stack management
+    Once you're familiar with {{< vendor/name >}}, its basic rules and philosophy, you may be curious about how you can replicate common workflows in other tools on our platform. 
+    From scheduling dependency updates and backups to exporting data, the [**Tutorials**](/learn/tutorials/_index.md) provide all the information you need.
 
-Managing your full stack on {{< vendor/name >}} gives you the following unique features:
+- [**Best practices**](/learn/bestpractices/_index.md)
 
-1. **Unified Environment:** All of your services (MySQL, ElasticSearch, MongoDB, etc.) are managed inside the cluster and included in the price, with no external single-points-of-failure. When you back up an environment, you get a fully consistent snapshot of your whole application.
-2. **Multi-Services & Multi-App:** You can deploy multiple applications (for example, in a microservice-based architecture), using multiple data backends (MySQL, PostgreSQL, Redis, etc.) written in multiple frameworks (Drupal + NodeJS + Flask, for example) in multiple languages, all in the same cluster.
-3. **Full Cluster Cloning Technology:** The full production cluster can be cloned in under a minute&mdash;including all of its data&mdash;to create on-the-fly, ephemeral development environments that are a byte-level copy of production.
-4. **Fail-Proof Deployments:** Every time you test a new feature, you also test the deployment process.
-5. **Continuous Deployment from the Start:** Everything is build-oriented, with a consistent, repeatable build process, simplifying the process of keeping your application up-to-date and secure.
+    {{< vendor/name >}} makes deploying and managing infrastructure no different than working with Git.
+    As your work becomes more experimental, however, you may be interested in optimizing your workflows, and addressing common constraints of the platform. 
+    The [**Best practices**](/learn/bestpractices/_index.md) documentation contains articles that address advanced use cases for caching, microservices, and more.
+
+### Frameworks
+
+Now that you understand the basic rules of {{< vendor/name >}}, you're likely ready to deploy your own custom code in a chosen framework. 
+The **Frameworks** section is a collection of framework-specific how-to guides - from best practices to configuration, local development, and more.
+
+| Language              | Frameworks |
+| :----------------     | :------  |
+| [Python](/languages/python/_index.md)                |   [Django](/guides/django/_index.md)  |
+| [PHP](/languages/php/_index.md)                      |   [Drupal](/guides/drupal9/_index.md)<br/>[Ibexa](/guides/ibexa/_index.md)<br/>[Laravel](/guides/laravel/_index.md)<br/>[Symfony](/guides/symfony/_index.md)<br/>[TYPO3](/guides/typo3/_index.md)<br/>[WordPress](/guides/wordpress/_index.md)   |
+| [Javascript/Node.js](/languages/nodejs/_index.md)     |  [Gatsby](/guides/gatsby/_index.md)<br/>[Next.js](/guides/nextjs/_index.md)<br/>[Strapi](/guides/strapi/_index.md)  |
+| [Java](/languages/java/_index.md)                  |  [Hibernate](/guides/hibernate/_index.md)<br/>[Jakarta](/guides/jakarta/_index.md)<br/>[Micronaut](/guides/micronaut/_index.md)<br/>[Quarkus](/guides/quarkus/_index.md)<br/>[Spring](/guides/spring/_index.md)  |
+
+### Reference 
+
+The **Reference documentation** section is the largest and most comprehensive. 
+It includes details of configuration, environment variables, activities, and much more material you can use in your day-to-day work.
+
+{{< home/table "services" >}}
+{{< home/table "languages" >}}
+{{< home/table "configuration" >}}
+{{< home/table "topics" >}}
+
+### API documentation
+
+Find out more about {{< vendor/name >}}'s GIT implementation and REST API, and how you can leverage them to manage every aspect of your projects, through {{< vendor/name >}}'s [API documentation](https://api.platform.sh/docs/).
+
+{{< version/specific >}}
+
+<!-- For now, most of these links are only relevant to Platform.sh -->
+### More docs, found elsewhere
+
+There are many resources available outside of the documentation that will help you work with {{< vendor/name >}}, including demos, talks, and podcasts. 
+
+[Check them out here](/learn/resources.md).
+
+To stay informed of all the latest {{< vendor/name >}} news, join our newsletter.
+
+<div style="margin-top: 3rem; text-align: center;">
+    <a class="start-cta font-semibold text-sm xl:text-base px-4 py-2 bg-skye rounded text-white hover:bg-skye-dark focus:bg-skye-dark"
+    href="https://platform.sh/preferences/" rel="noopener">Sign up for the newsletter</a>
+</div>
+
+<--->
+
+<!-- TBD: white-label version when available -->
+
+{{< /version/specific >}}
+
+
+## Connect with us
+
+### Join the community
+
+The {{< vendor/name >}} community meets on both a [Community forum](https://community.platform.sh) and [Slack](https://chat.platform.sh) for questions and discussion. 
+
+Have an experiment you'd like to share? 
+Looking for a way to contribute?
+
+<div style="margin-top: 3rem; text-align: center;">
+    <a class="start-cta font-semibold text-sm xl:text-base px-4 py-2 bg-skye rounded text-white hover:bg-skye-dark focus:bg-skye-dark"
+    href="https://chat.platform.sh" rel="noopener">Join us on Slack</a>
+</div>
+
+### Contribute
+Feel free to open an issue or pull request for any of the repositories below, or let us know on [Slack](https://chat.platform.sh) if you find a problem we can help with:
+
+{{< home/links-github >}}
+
+### Get support
+
+If you're experiencing issues with your projects, don't hesitate to open a [support ticket](/learn/overview/get-support).

sites/platform/src/add-services/elasticsearch.md

@@ -183,7 +183,7 @@ use the `elasticsearch-enterprise` type.
 
 In this example you'd have the ICU analysis plugin and Python script support plugin.
 
-If there is a publicly available plugin you need that isn't listed here, [contact support](../overview/get-support.md).
+If there is a publicly available plugin you need that isn't listed here, [contact support](/learn/overview/get-support.md).
 
 ### Available plugins
 

sites/platform/src/add-services/opensearch.md

@@ -128,7 +128,7 @@ search:
 
 In this example you'd have the ICU analysis plugin and the size mapper plugin.
 
-If there is a publicly available plugin you need that isn't listed here, [contact support](../overview/get-support.md).
+If there is a publicly available plugin you need that isn't listed here, [contact support](/learn/overview/get-support.md).
 
 ### Available plugins
 

sites/platform/src/administration/organizations.md

@@ -104,7 +104,7 @@ platform organization:info --org acme
 As an organization owner, you can delete your own organization.
 
 Note that if your organization owns projects or owes remaining invoices, you can not delete it yourself.
-To have it deleted, [contact support](../overview/get-support.md).
+To have it deleted, [contact support](/learn/overview/get-support.md).
 
 {{< codetabs >}}
 

sites/platform/src/create-apps/hooks/_index.md

@@ -4,7 +4,7 @@ description: Add custom scripts at different stages in the build and deploy proc
 layout: single
 ---
 
-As your app goes through the [build and deploy process](../../overview/build-deploy.md),
+As your app goes through the [build and deploy process](/learn/overview/build-deploy.md),
 you might want to run custom commands.
 These might include compiling the app, setting the configuration for services based on variables, and rebuilding search indexes.
 Do these tasks using one of [three hooks](./hooks-comparison.md).