/developer-guides

Content for neo4j.com/developer

Primary LanguagePython

Neo4j Developer Guides

Installation

To build these docs locally you will need Node & NPM installed. Antora requires Node version 10 or higher.

To install the dependencies run:

npm install

Contributing

To 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-fix

At 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.

Live Preview

To preview the docs run:

npm start

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