To build these docs locally you will need Node & NPM installed. Antora requires Node version 10 or higher.
To install the dependencies run:
npm installTo make changes to this repository, please create a new branch to stage your changes.
Your branch should be prefixed with the type of change, for example content/new-cypher-guide or fix/broken-links.
When you are finished with your changes push the branch to the remote repository and create a Pull Request. Please add at least one approver.
The changes will be merged into the publish branch, which will in turn trigger a rebuild of the content in the docs-refresh repository.
# Clone the repository
git clone https://github.com/neo4j-documentation/developer-guides
# check out a new branch
git checkout -b content/my-fix
# Make some changes to the repo
touch modules/ROOT/pages/new-guide.adoc
# State the changes
git add modules/ROOT/pages/new-guide.adoc
# Commit the changes
git commit -m "Added a new guide"
# Push to the remote repository
git push -u origin content/my-fixAt the end of the build process, the files are uploaded to the static-content.neo4j.com S3 Bucket. From there, they are synced up to the Neo4j.com server once an hour, on the hour by a cronjob.
To preview the docs run:
npm startThis will build a set of HTML files in build/site and then serve them through an express server at http://localhost:8000.
The dev script will also listen for changes and automatically rebuild the files automatically.
You’ll still need to refresh the page to view the changes.