From 92c7288816e7bf910ffb36a7506ae639cd3180e5 Mon Sep 17 00:00:00 2001
From: Anton Dosov <anton.dosov@elastic.co>
Date: Mon, 11 Dec 2023 15:20:23 +0100
Subject: [PATCH] Consolidate shared ux team dev docs (#172966)

## Summary

This PR consolidates shared ux team dev docs similar how it was done by
operations team.

There is a separate "Shared UX" toc in the nav with the team's
catalogue. Also a landing page with our catalog.

<img width="1185" alt="Screenshot 2023-12-08 at 17 01 15"
src="https://github.com/elastic/kibana/assets/7784120/c8e758f0-bcaa-4c74-9187-2911b2e7a680">
---
 dev_docs/shared_ux/shared_ux_landing.mdx      | 70 ++++++++++++++++++
 nav-kibana-dev.docnav.json                    | 72 +++++++++++++------
 packages/react/kibana_context/README.mdx      |  6 +-
 .../docs/conent_management_landing.mdx        | 22 ++++++
 4 files changed, 147 insertions(+), 23 deletions(-)
 create mode 100644 dev_docs/shared_ux/shared_ux_landing.mdx
 create mode 100644 src/plugins/content_management/docs/conent_management_landing.mdx

diff --git a/dev_docs/shared_ux/shared_ux_landing.mdx b/dev_docs/shared_ux/shared_ux_landing.mdx
new file mode 100644
index 0000000000000..2b6bc7661dedd
--- /dev/null
+++ b/dev_docs/shared_ux/shared_ux_landing.mdx
@@ -0,0 +1,70 @@
+---
+id: kibDevDocsSharedUxOverview
+slug: /kibana-dev-docs/shared-ux
+title: Shared UX Team
+description: Links to all the documentation maintained by the Shared UX team.
+tags: ['kibana', 'dev', 'shared-ux']
+layout: landing
+---
+
+<DocLandingHero
+  title="Welcome to Shared UX team docs!"
+  description="👋 Here you will find documentation about all the things the Shared UX team manages. Feel free to look around and ask questions!"
+/>
+
+<DocRelatedArticles
+  sectionTitle="About the team"
+  items={[
+    {
+      title: 'Team Wiki',
+      description: 'Learn more about the team and what we do.',
+      href: 'https://wiki.elastic.co/display/DEV/AppEx+SharedUX+Team',
+    },
+  ]}
+/>
+
+<DocRelatedArticles
+  sectionTitle="Our Catalog"
+  items={[
+    {
+      pageId: 'kibDevTutorialsServerlessProjectNavigation',
+      title: 'Serverless Project Navigation',
+      description: 'Learn how to work with the new chrome navigation in serverless projects',
+    },
+    {
+      pageId: 'kibDevTutorialFileService',
+      title: 'File service',
+      description: 'Learn how to add files uploading and downloading to your plugin',
+    },
+    {
+      pageId: 'kibDevSharePluginReadme',
+      title: 'Sharing',
+      description: 'Learn how to add short URLs to your plugin',
+    },
+    {
+      title: 'Content Management',
+      pageId: 'kibContentManagement',
+      description: 'Learn about the content management system in Kibana',
+    },
+    {
+      pageId: 'kibDevTutorialScreenshotting',
+      title: 'Reporting / Screenshotting',
+      description: 'Learn how to integrate your plugin with reporting',
+    },
+    {
+      pageId: 'kibDevTutorialAdvancedSettings',
+      title: 'Advanced Settings (uiSettings)',
+      description: 'Learn how to register advanced settings for your plugin',
+    },
+    {
+      pageId: 'kibDevDocsKPTTutorial',
+      title: 'Kibana Page Template',
+      description: "Learn how to use Kibana Page Template for your app's page layout",
+    },
+    {
+      pageId: 'kibDevReactKibanaContext',
+      title: 'Kibana React Contexts',
+      description: 'Learn how to use common React contexts in Kibana',
+    },
+  ]}
+/>
diff --git a/nav-kibana-dev.docnav.json b/nav-kibana-dev.docnav.json
index b724286d5bac3..d4eb3aaba6dd9 100644
--- a/nav-kibana-dev.docnav.json
+++ b/nav-kibana-dev.docnav.json
@@ -25,15 +25,6 @@
         }
       ]
     },
-    {
-      "label": "Operations",
-      "items": [
-        {
-          "id": "kibDevDocsOpsOverview",
-          "label": "Overview"
-        }
-      ]
-    },
     {
       "label": "Contributing",
       "items": [
@@ -149,9 +140,6 @@
         {
           "id": "kibDevTutorialExpressions"
         },
-        {
-          "id": "kibDevDocsKPTTutorial"
-        },
         {
           "id": "kibDevTutorialDataSearchAndSessions",
           "label": "data.search"
@@ -178,15 +166,21 @@
         },
         {
           "id": "kibDevTutorialAdvancedSettings"
-        },
+        }
+      ]
+    },
+    {
+      "label": "Serverless",
+      "pageId": "ktServerlessReleaseOverview",
+      "items": [
         {
-          "id": "kibDevSharePluginReadme"
+          "id": "ktServerlessReleaseOverview"
         },
         {
-          "id": "kibDevTutorialScreenshotting"
+          "id": "ktServerlessEmergencyReleases"
         },
         {
-          "id": "kibDevTutorialsContentManagementOnboarding"
+          "id": "ktCustomServerlessImage"
         },
         {
           "id": "kibDevTutorialsServerlessProjectNavigation"
@@ -194,16 +188,54 @@
       ]
     },
     {
-      "label": "Serverless",
+      "label": "Operations",
       "items": [
         {
-          "id": "ktServerlessReleaseOverview"
+          "id": "kibDevDocsOpsOverview",
+          "label": "Overview"
+        }
+      ]
+    },
+    {
+      "label": "Shared UX",
+      "pageId": "kibDevDocsSharedUxOverview",
+      "items": [
+        {
+          "label": "Serverless Project Navigation",
+          "id": "kibDevTutorialsServerlessProjectNavigation"
         },
         {
-          "id": "ktServerlessEmergencyReleases"
+          "id": "kibDevTutorialFileService",
+          "label": "File service"
         },
         {
-          "id": "ktCustomServerlessImage"
+          "id": "kibDevSharePluginReadme",
+          "label": "Sharing"
+        },
+        {
+          "label": "Content Management",
+          "id": "kibContentManagement",
+          "items": [
+            {
+              "id": "kibDevTutorialsContentManagementOnboarding"
+            }
+          ]
+        },
+        {
+          "id": "kibDevTutorialScreenshotting",
+          "label": "Screenshotting"
+        },
+        {
+          "id": "kibDevTutorialAdvancedSettings",
+          "label": "Advanced Settings"
+        },
+        {
+          "id": "kibDevDocsKPTTutorial",
+          "label": "Kibana Page Template"
+        },
+        {
+          "id": "kibDevReactKibanaContext",
+          "label": "Kibana React Contexts"
         }
       ]
     },
diff --git a/packages/react/kibana_context/README.mdx b/packages/react/kibana_context/README.mdx
index 28fd9ecb1600f..8738461245e65 100644
--- a/packages/react/kibana_context/README.mdx
+++ b/packages/react/kibana_context/README.mdx
@@ -1,9 +1,9 @@
 ---
-id: react/context
-slug: /react/context
+id: kibDevReactKibanaContext
+slug: /kibana-dev-docs/react-context
 title: React Contexts in Kibana
 description: Kibana uses React Context to manage several global states.  This is a collection of packages supporting those states.
-tags: ['shared-ux', 'react', 'context']
+tags: ['kibana', 'dev','shared-ux', 'react', 'context']
 date: 2023-07-25
 ---
 
diff --git a/src/plugins/content_management/docs/conent_management_landing.mdx b/src/plugins/content_management/docs/conent_management_landing.mdx
new file mode 100644
index 0000000000000..b2855d105c7db
--- /dev/null
+++ b/src/plugins/content_management/docs/conent_management_landing.mdx
@@ -0,0 +1,22 @@
+---
+id: kibContentManagement
+slug: /kibana-dev-docs/content-management
+title: Content Management
+date: 2023-04-13
+tags: ['kibana', 'dev', 'content management', 'saved objects']
+---
+
+<DocLandingHero
+  title="🚧 Under construction"
+  description="Here you will find documentation about content management framework in Kibana"
+/>
+
+Kibana Saved Objects have traditionally been considered content,
+but the content management project aims to provide a single abstraction for Kibana and solution content.
+This includes the registration and collection of content metadata as well as the rendering capabilities, caching layer, backward compatible CRUD & Search APIs,
+and eventually a collection of new features that enhance content items by adding additional capabilities for personalization, private objects and content folders.
+
+## Links
+
+- <DocLink id="kibDevTutorialsContentManagementOnboarding" text="Content Management onboarding" />
+- <DocLink id="kibContentManagementPluginApi" text="Content Management plugin API reference" />