docs: start bringing structure from /docs to docusaurus

docs/overview/architecture-overview.md

@@ -1,3 +1,8 @@
+---
+id: architecture-overview
+title: Architecture overview
+---
+
 # Typical Backstage architecture
 
 The following diagram shows how Backstage might look when deployed inside a

docs/overview/architecture-terminology.md

@@ -1,3 +1,8 @@
+---
+id: architecture-terminology
+title: Architecture terminology
+---
+
 # Architecture and Terminology
 
 Backstage is constructed out of three parts. We separate Backstage in this way

docs/overview/roadmap.md

@@ -1,3 +1,8 @@
+---
+id: roadmap
+title: Project roadmap
+---
+
 # Project roadmap
 
 We created Backstage about 4 years ago. While our internal version of Backstage

docs/overview/what-is-backstage.md

@@ -1,8 +1,11 @@
+---
+id: what-is-backstage
+title: What is Backstage?
+---
+
 # [Backstage](https://backstage.io)
 
-![headline](../headline.png)
-
-## What is Backstage?
+![headline](../assets/headline.png)
 
 [Backstage](https://backstage.io/) is an open platform for building developer
 portals. It’s based on the developer portal we’ve been using internally at

microsite/i18n/en.json

@@ -149,9 +149,8 @@
       "getting-started/development-environment": {
         "title": "getting-started/development-environment"
       },
-      "getting-started/getting-started-index": {
-        "title": "Getting started",
-        "sidebar_label": "Getting started"
+      "getting-started/index": {
+        "title": "getting-started/index"
       },
       "getting-started/installation": {
         "title": "getting-started/installation"
@@ -160,19 +159,19 @@
         "title": "journey"
       },
       "overview/architecture-overview": {
-        "title": "overview/architecture-overview"
+        "title": "Architecture overview"
       },
       "overview/architecture-terminology": {
-        "title": "overview/architecture-terminology"
+        "title": "Architecture terminology"
       },
       "overview/roadmap": {
-        "title": "overview/roadmap"
+        "title": "Project roadmap"
       },
       "overview/support": {
         "title": "overview/support"
       },
       "overview/what-is-backstage": {
-        "title": "overview/what-is-backstage"
+        "title": "What is Backstage?"
       },
       "plugins/backend-plugin": {
         "title": "plugins/backend-plugin"
@@ -274,12 +273,7 @@
       "Newsletter": "Newsletter"
     },
     "categories": {
-      "Getting Started": "Getting Started",
-      "Plugins": "Plugins",
-      "Test": "Test",
-      "API Overview": "API Overview",
-      "Layout components": "Layout components",
-      "Testing": "Testing"
+      "Overview": "Overview"
     }
   },
   "pages-strings": {

microsite/sidebars.json

@@ -1,17 +1,10 @@
 {
   "docs": {
-    "Getting Started": ["getting-started/getting-started-index"],
-    "Plugins": [
-      "developing-a-plugin",
-      "plugin-api",
-      "create-plugin-api-v2",
-      "plugin-structure",
-      "components",
-      "errors-notifications"
-    ],
-    "Test": ["test"],
-    "API Overview": ["apis"],
-    "Layout components": ["layout-components"],
-    "Testing": ["testing-with-jest"]
+    "Overview": [
+      "overview/what-is-backstage",
+      "overview/architecture-overview",
+      "overview/architecture-terminology",
+      "overview/roadmap"
+    ]
   }
 }

microsite/siteConfig.js

@@ -38,10 +38,10 @@ const siteConfig = {
       href: 'https://github.com/spotify/backstage#backstage',
       label: 'GitHub',
     },
-    // {
-    //   doc: 'getting-started/getting-started-index',
-    //   label: 'Docs',
-    // },
+    {
+      doc: 'overview/what-is-backstage',
+      label: 'Docs',
+    },
     {
       page: 'blog',
       blog: true,