Learn more with the Gitpod Docs

You only have to do this step the first time, to create a Gitpod account, after that you can just click the green buttons. For more information on setting up an account, see https://gitpod.io/plans

NOTE: Authenticate with the Github account you use in the Good Docs Project.

The Browser Extension will add GitPod buttons to the GitHub UI to make it easier to launch GitPod from appropriate contexts in the project.

This should launch Gitpod and a web based editor with live preview.

NOTE: The context in which you click the button, will change the gitpod environment and remote connections for you.

This works a lot like how tools like VS Code work, where you stage your changes and commit to the branch or your fork and submit a PR to the main branch of the project. Only when you are done you just close the browser and nothing is left behind on your computer.

This is for quick changes, or when preview of your work on the site is unnecessary.

Read the Documentation on the Github Site

NOTE: It is best practice to choose the "Create a new branch for this commit and start a pull request." option when commiting your changes to the project. Then assign the Pull Request to someone else in the project to take a look at it before you merge it.

Quick instructions for getting started if you're on Mac OSX.

• Brew installed
• NodeJS installed

These are the step-by-step instructions one can execute to configure a local environment. Note: This does use a git submodule for the Docsy theme, so using the correct git clone command is important.

# Installs the Hugo Binary that will be used to build and run the Hugo Server
brew install hugo

# Clone the repo locally
git clone --recurse-submodules --depth 1 [email protected]:thegooddocsproject/website-hugo.git

# Enter the default working path
cd website-hugo

# Installs the CSS processor
npm install

# Run the build process/http service
hugo server