This is the code for Serverpod's official documentation. If you are contributing, please only edit files in the docs directory. The Serverpod team will handle any updates to existing versions if necessary. You can view the updated documentation by choosing the Next option in the top menu bar.
Make sure that you have Node.js installed on your computer.
$ cd serverpod_docs
$ npm install$ npm startThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Make sure that the documentation is all up-to-date then run:
npm run docusaurus docs:version X.X.XIf you need to make changes to the latest version, you can do so by removing the latest version from versions.json and adding it again running the create version command with the same version number.
npm run docusaurus docs:version X.X.XTo maintain link integrity when relocating or renaming documentation pages, it's recommended to implement redirects. This is facilitated by the @docusaurus/plugin-client-redirects plugin. Redirects can be configured in the docusaurus.config.js file, within the redirects section of the plugin configuration.
Once a PR is merged into the main branch of this repository, a GitHub action is triggered that builds the documentation and pushes the build to the docs directory within the serverpod.github.io repository. The built documentation is committed as a new commit to the main branch and is then deployed to Github pages by the serverpod.github.io repository.
To ensure consistent formatting, we use markdownlint (VS Code Extension)
Install the markdownlint-cli globally, by running the following command from your terminal:
$ npm install -g markdownlint-cliFormatting is only enforced in /serverpod_docs/docs/ directory so therefore you only need to run the markdownlint-cli in this folder with:
$ markdownlint './docs/**/*.md'To do this you need access to the Serverpod Github serverpod.github.io repository. Clone it next to the serverpod_web repo.
$ util/deploy