chore: enable docs versioning (#250)

Author: ymc9

docusaurus.config.js

@@ -34,6 +34,11 @@ const config = {
                     sidebarPath: require.resolve('./sidebars.js'),
                     path: 'docs',
                     editUrl: 'https://github.com/zenstackhq/zenstack-docs/edit/main',
+                    versions: {
+                        current: {
+                            label: '2.0 🚧',
+                        },
+                    },
                 },
                 blog: {
                     showReadingTime: true,
@@ -96,6 +101,10 @@ const config = {
                         label: 'Discord',
                         position: 'right',
                     },
+                    {
+                        type: 'docsVersionDropdown',
+                        position: 'right',
+                    },
                     {
                         type: 'html',
                         position: 'left',

package.json

@@ -37,6 +37,7 @@
         "@docusaurus/types": "^3.1.1",
         "@tailwindcss/typography": "^0.5.9",
         "@tsconfig/docusaurus": "^2.0.2",
+        "@types/node": "^20.11.17",
         "@types/react": "^18.0.26",
         "typescript": "^5.3.3"
     },

pnpm-lock.yaml

@@ -0,0 +1,5 @@
+- Email/password based signin/signup.
+- `Space` for multi-tenancy management. Users can join multiple spaces, and a space can have many users.
+- Users can be of "USER" or "ADMIN" role in a space. Space admins can manage space members.
+- Users can manage Todo lists and items in spaces they belong to.
+- Public Todo lists are accessible to all space members. Private lists are only accessible to the owner and space admins.

versioned_docs/version-1.x/_components/_todo-requirements.md

@@ -0,0 +1,7 @@
+import ZenStackInit from './_zenstack-init.md'
+
+:::tip
+
+<ZenStackInit />
+
+:::

versioned_docs/version-1.x/_components/_zenstack-init-tips.md

@@ -0,0 +1,10 @@
+The "init" command does the following things for you:
+
+1. Install Prisma if it's not already installed.
+2. Install the `zenstack` CLI package as a dev dependency.
+3. Install the `@zenstackhq/runtime` package - used for enhancing `PrismaClient` at the runtime.
+4. Copy the `prisma/schema.prisma` file to `schema.zmodel` if it exists; otherwise, create a new template `schema.zmodel` file.
+
+You can always manually complete the steps above if you have a special project setup that the "init" command doesn't work with.
+
+After the initialization, please remember that you should edit the `schema.zmodel` moving forward. The `prisma/schema.prisma` file will be automatically regenerated when you run `zenstack generate`.