This repository contains the source files and various generators for the Memgraph documentation available at memgraph.com/docs.
To run the documentation website locally, you will need to install:
- Node.js version >= 16.0.0 or above (which
can be checked by running
node -v). You can use nvm for managing multiple Node versions on a single machine installed. - pnpm
To preview your changes as you edit the files, you can run a local development server that will serve your website and reflect the latest changes.
First install node and pnpm. After that, clone this repository:
git clone https://github.com/memgraph/documentation.git
Change the working directory to the one of the cloned repository and install the dependencies:
pnpm iNow, you can start the server:
pnpm devOpen the URL http://localhost:3000/docs in your browser.
Install the dependencies:
pnpm iBuild the website:
pnpm buildContents will be generated within the /build directory.
Test your build locally:
pnpm startWe are grateful for any community contributions to the documentation, as they are the best way of improving the overall user experience. If at any point you believe that something is misleading, could be worded better, or is missing additional information, then please feel free to make a pull request or report an issue.
If you want to change the documentation, create a new branch and make the
appropriate changes. Then, create a pull request to merge these changes into the
main branch.
The pull request should describe the changes it's proposing and all checks must be completed.
Add an appropriate label to the PR, either status: draft if you are still
working on the PR, or status: ready if the PR is ready for review.
When the PR is reviewed and approved, the label will be changed to status: ship it and merged into the main by the repo admins.
If the PR requires changes, the label will be changed to status: change.
Address the comments and change the documentation appropriately, then re-request
a review and change the label to status: ready again.