docs: new nav (#19188)

docs/usage/.pages

+nav:
+  - Home: 'index.md'
+  - ... | getting-started
+  - Troubleshooting: 'troubleshooting.md'
+  - Configuration:
+      - 'Self-hosted': 'self-hosted-configuration.md'
+      - 'Repository': 'configuration-options.md'
+      - 'Presets': 'config-presets.md'
+  - ... | key-concepts
+  - ... | modules
+  - Language Support:
+      - 'Bazel': 'bazel.md'
+      - 'Docker': 'docker.md'
+      - 'Golang': 'golang.md'
+      - 'Java': 'java.md'
+      - 'JavaScript': 'javascript.md'
+      - 'Node.js Versions': 'node.md'
+      - 'Nuget': 'nuget.md'
+      - 'PHP': 'php.md'
+      - 'Python': 'python.md'
+      - 'Ruby': 'ruby.md'
+  - Deep Dives:
+      - 'Should you Pin your Javascript Dependencies?': 'dependency-pinning.md'
+      - 'Config Template Editing': 'configuration-templates.md'
+      - 'Updating and Rebasing Branches': 'updating-rebasing.md'
+      - 'Semantic Commit Messages': 'semantic-commits.md'
+      - 'Noise Reduction': 'noise-reduction.md'
+  - Included Presets:
+      - 'Compatibility Presets': 'presets-compatibility.md'
+      - 'Default Presets': 'presets-default.md'
+      - 'Docker Presets': 'presets-docker.md'
+      - 'Full Config Presets': 'presets-config.md'
+      - 'Group Presets': 'presets-group.md'
+      - 'Helper Presets': 'presets-helpers.md'
+      - 'Monorepo Presets': 'presets-monorepo.md'
+      - 'npm Presets': 'presets-npm.md'
+      - 'Package Presets': 'presets-packages.md'
+      - 'Preview Presets': 'presets-preview.md'
+      - 'Regex Manager Presets': 'presets-regexManagers.md'
+      - 'Replacement Presets': 'presets-replacements.md'
+      - 'Schedule Presets': 'presets-schedule.md'
+      - 'Workaround Presets': 'presets-workarounds.md'
+  - All Other:
+      - ... | user-stories
+      - 'Security and Permissions': 'security-and-permissions.md'
+      - 'Merge Confidence': 'merge-confidence.md'
+      - 'Templates': 'templates.md'
+      - 'Frequently Asked Questions': 'faq.md'
+      - 'Known Limitations': 'known-limitations.md'
+      - 'Release notes for major versions': 'release-notes-for-major-versions.md'
+  - About Us: 'about-us.md'

docs/usage/getting-started/.pages

+title: Getting Started
+nav:
+  - 'Use Cases': 'use-cases.md'
+  - 'Running Renovate': 'running.md'
+  - 'Self-Hosting Examples': '/examples/self-hosting'
+  - 'Installing & Onboarding': 'installing-onboarding.md'
+  - 'Private Packages': 'private-packages.md'

docs/usage/key-concepts/.pages

+nav:
+  - 'Presets': 'presets.md'
+  - 'Dependency Dashboard': 'dashboard.md'
+  - 'Pull Requests': 'pull-requests.md'
+  - 'Renovate Scheduling': 'scheduling.md'
+  - 'Automerge': 'automerge.md'

docs/usage/modules/.pages

+title: Renovate Modules
+order: asc
+sort_type: natural

docs/usage/modules/manager/.pages

+title: Managers
+nav:
+  - index.md
+# TODO: add all managers ?
+#  - Introduction: index.md
+#  - ...
+collapse_single_pages: true
+order: asc
+sort_type: natural

docs/usage/modules/platform/.pages

+title: Platforms
+nav:
+  - Introduction: index.md
+  - ...
+collapse_single_pages: true
+order: asc
+sort_type: natural

docs/usage/user-stories/.pages

+title: User Stories
+nav:
+  - 'Swissquote': 'swissquote.md'
+

tools/docs/manager.ts

@@ -212,7 +212,7 @@ sidebar_label: ${displayName}
     languageText += allLanguages[language].map(getManagerLink).join(', ');
     languageText += '\n\n';
   }
-  let indexContent = await readFile(`docs/usage/modules/manager.md`);
+  let indexContent = await readFile(`docs/usage/modules/manager/index.md`);
   indexContent = replaceContent(indexContent, languageText);
-  await updateFile(`${dist}/modules/manager.md`, indexContent);
+  await updateFile(`${dist}/modules/manager/index.md`, indexContent);
 }

tools/docs/platforms.ts

@@ -20,8 +20,8 @@ export async function generatePlatforms(dist: string): Promise<void> {
 
   platformContent += '.\n';
 
-  const indexFileName = `docs/usage/modules/platform.md`;
+  const indexFileName = `docs/usage/modules/platform/index.md`;
   let indexContent = await readFile(indexFileName);
   indexContent = replaceContent(indexContent, platformContent);
-  await updateFile(`${dist}/modules/platform.md`, indexContent);
+  await updateFile(`${dist}/modules/platform/index.md`, indexContent);
 }

tools/generate-docs.ts

@@ -31,7 +31,7 @@ process.on('unhandledRejection', (err) => {
     }
 
     logger.info('* static');
-    r = shell.cp('-r', 'docs/usage/*', `${dist}/`);
+    r = shell.cp('-r', 'docs/usage/.', `${dist}`);
     if (r.code) {
       return;
     }