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 start

This 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.X

If 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.X

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 do this you need access to the Serverpod Github serverpod.github.io repository. Clone it next to the serverpod_web repo.

$ util/deploy