Webiste registry adjustments

Author: danieldelcore

.gitignore

@@ -3,7 +3,7 @@
 plugin_packages/
 
 # Generated website pages
-website/docs/registry/*
+website/docs/registry-generated/*
 
 # Logs
 logs

scripts/docs.ts

@@ -6,7 +6,13 @@ import { CodeshiftConfig } from '@codeshift/types';
 import { fetchConfig } from '@codeshift/fetcher';
 
 const COMMUNITY_PATH = path.join(__dirname, '..', 'community');
-const DOCS_PATH = path.join(__dirname, '..', 'website', 'docs', 'registry');
+const DOCS_PATH = path.join(
+  __dirname,
+  '..',
+  'website',
+  'docs',
+  'registry-generated',
+);
 
 function cleanTargetDir(targetPath: string) {
   if (fs.existsSync(targetPath)) fs.emptyDirSync(targetPath);
@@ -47,12 +53,13 @@ async function main() {
       `---
 id: ${safeName}
 title: ${safeName.replace('__', '/')}
-slug: /${safeName}
+slug: /registry/${safeName}
 ---
 
 **Target package:** ${packageLink}
 
 **Maintainers:**
+
 ${config.maintainers!.map(
   maintainer => `- [${maintainer}](https://github.com/${maintainer})`,
 )}
@@ -70,7 +77,7 @@ ${Object.keys(config.transforms)
 
 Migrates ${packageLink} to version ${key}.
 
-### Usage
+#### Usage
 
 \`\`\`
 $ codeshift --packages ${name}@${key} path/to/source
@@ -93,7 +100,7 @@ ${Object.keys(config.presets)
 
 [Source](https://github.com/CodeshiftCommunity/CodeshiftCommunity/tree/main/community/${urlSafeName}) | [Report an issue](https://github.com/CodeshiftCommunity/CodeshiftCommunity/issues/new?title=${safeName}@${key})
 
-### Usage
+#### Usage
 
 \`\`\`
 $ codeshift --packages ${name}#${key} path/to/source

website/docs/authoring.mdx

@@ -23,7 +23,7 @@ Use this method if you want:
 - Your codemods to be open source
 - Build tooling, dependency management and project setup to be handled for you
 - The community to help maintain and contribute to your codemods
-- Documentation to be automatically generated and available on the [Regisistry page](atlaskit__avatar)
+- Documentation to be automatically generated and available on the [Regisistry page](registry)
 
 Do not use this method if:
 
@@ -46,7 +46,7 @@ Use this method if you want:
 
 Do not use this method if:
 
-- You want docs to be automatically generated and available on the [Regisistry page](atlaskit__avatar)
+- You want docs to be automatically generated and available on the [Regisistry page](registry)
 
 ## 3. Create a stand-alone codeshift package
 

website/docs/contribution.mdx

@@ -9,7 +9,7 @@ This page covers contribution to the [Community Folder](https://github.com/Codes
 - Codemods to be open source
 - Build tooling, dependency management and project setup to be handled for you
 - The community to help maintain and contribute to your codemods
-- Documentation to be automatically generated and available on the [Regisistry page](atlaskit__avatar)
+- Documentation to be automatically generated and available on the [Regisistry page](registry)
 
 If you prefer to create codemods outside of this repo, please see the [Authoring guide](authoring) for other options.
 

website/docs/registry.mdx

@@ -0,0 +1,11 @@
+---
+id: registry
+title: Registry
+slug: /registry
+---
+
+Welcome to the CodeshiftCommunity Registry. Here we list community owned and maintained Codeshift packages.
+
+Source for these packages are located in the repository [/community folder](https://github.com/CodeshiftCommunity/CodeshiftCommunity/tree/main/community).
+
+To contribute to the Registry please see the [Contribution guide](/docs/contribution). For other publishing options, including private codemod packages, please refer to the [Authoring guide](/docs/authoring).

website/docusaurus.config.js

@@ -35,7 +35,7 @@ module.exports = {
         },
         {
           type: 'doc',
-          docId: 'registry/atlaskit__avatar',
+          docId: 'registry',
           label: 'Registry',
           position: 'left',
         },

website/package.json

@@ -14,8 +14,8 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.0",
-    "@docusaurus/preset-classic": "2.0.0-beta.0",
+    "@docusaurus/core": "2.0.0-beta.18",
+    "@docusaurus/preset-classic": "2.0.0-beta.18",
     "@mdx-js/react": "^1.6.21",
     "clsx": "^1.1.1",
     "react": "^17.0.1",

website/sidebars.js

@@ -1,8 +1,8 @@
 module.exports = {
   docs: [
     {
-      type: 'category',
       label: 'Getting Started',
+      type: 'category',
       collapsed: false,
       items: [
         'introduction',
@@ -13,8 +13,8 @@ module.exports = {
       ],
     },
     {
-      type: 'category',
       label: 'Docs',
+      type: 'category',
       collapsed: false,
       items: [
         'authoring',
@@ -27,8 +27,8 @@ module.exports = {
       ],
     },
     {
-      type: 'category',
       label: 'Guides',
+      type: 'category',
       collapsed: false,
       items: [
         'guides/your-first-codemod',
@@ -38,24 +38,37 @@ module.exports = {
       ],
     },
     {
-      type: 'category',
       label: 'Recipes',
+      type: 'category',
       collapsed: false,
       items: ['recipes/import-manipulation', 'recipes/react'],
     },
   ],
   api: [
     {
-      type: 'category',
       label: 'Packages',
+      type: 'category',
+      collapsible: false,
       collapsed: false,
       items: ['api/cli', 'api/utils', 'api/test-utils'],
     },
   ],
   registry: [
     {
-      dirName: 'registry',
-      type: 'autogenerated',
+      label: 'Registry',
+      type: 'category',
+      collapsible: false,
+      collapsed: false,
+      link: {
+        type: 'doc',
+        id: 'registry',
+      },
+      items: [
+        {
+          dirName: 'registry-generated',
+          type: 'autogenerated',
+        },
+      ],
     },
   ],
 };