Documentation for Dgraph Cloud
To read the official Dgraph documentation that is published from this repository,
please visit dgraph.io/docs/cloud/.
As a contributor to Dgraph documentation, we ask that you do the following:
Develop in the master
branch first: Make any changes applicable to the current (recently-released) version of Dgraph in the master
branch first.
Link to discuss.dgraph.io posts when applicable: If your PR is based on discussions on Discuss, feel free to include a link to the relevant discussion in your PR description.
Technical writing style: As much as possible, please follow technical writing style conventions (More on this below).
(Dgraph core team only): Include the ID of any issues/tickets related to your PR in the description (i.e., “Fixes DGRAPH-12345” or “Per DGRAPH-54321”).
Dgraph Labs uses a style guide for our documentation so that we can make it as easy to understand as possible. The Dgraph Style Guide is a concise style reference for our documentation, but it isn’t comprehensive. For anything not found in our style guide, use Google’s Developer Docs Style Guide.
Making our documentation easy to understand includes optimizing it for client-side machine translation into other languages. To help with this, please see the following technical writing style tips:
Note: Please don’t let these style conventions stop you from creating a PR to share your contribution to Dgraph Docs! PR reviewers can help with style guide issues.
We use Hugo for our documentation. You can use Hugo to locally stage doc updates before or after creating a PR.
pushd ~/Downloads
VERSION=v0.79
TAG=$(curl -s https://api.github.com/repos/gohugoio/hugo/releases | jq '.[].tag_name' -r | grep $VERSION | head -1)
OS=$(uname -s)
if [[ ${OS,,} == "darwin" ]]; then
PKG=hugo_${TAG##v}_macOS-64bit.tar.gz
curl -sLO https://github.com/gohugoio/hugo/releases/download/${TAG}/${PKG}
tar xvzf $PKG hugo
sudo mv hugo /usr/local/bin/
else
PKG=hugo_${TAG##v}_Linux-64bit.deb
curl -sLO https://github.com/gohugoio/hugo/releases/download/${TAG}/${PKG}
sudo apt install $PKG
fi
popd
pushd themes && git clone https://github.com/dgraph-io/hugo-docs && popd
./scripts/local.sh
and visit http://localhost:1313 to see the documentation site running on your local machine.The documentation uses a hugo
theme which can be found at github.com/dgraph-io/hugo-docs.