This repository contains the source code for the user documentation for GoCD. The documentation is available at https://docs.gocd.org/current/.
We encourage you to contribute to GoCD. For information on contributing to GoCD, please see our contributor's guide. A lot of useful information like links to user documentation, design documentation, mailing lists etc. can be found in the resources section.
To make changes to GoCD's documentation, you can do this:
-
Install all dependencies
The dependencies for building the documentation are:
- nodejs (known to work with v8.9.4)
- yarn (known to work with 1.13.0)
- Ruby (known to work with 2.3.6)
- Bundler gem (known to work with 1.17.2)
Then run this to get all the dependent gems:
bundle install --jobs 4 --path .bundle --clean
-
Run the documentation on the local server (defaults to http://localhost:1313)
yarn run serve
The contents of the public
directory needs to be pushed out to the gh-pages branch of the repository.
bundle exec rake publish
Check the latest changes deployed here.
yarn run hugo [arguments]
Update the list of directories to be updated in the sync script. Run the sync script to copy over changes from the current docs repository Go through the changes to see if everything can be committed and then push the code.
bash ./sync.sh
Assuming current stable is 17.4.0
, you are about to release 17.5.0
and the next version is going to be 17.6.0
, you would execute -
CURRENT_VERSION=17.4.0 VERSION_TO_RELEASE=17.5.0 NEXT_VERSION=17.6.0 REMOTE_NAME=upstream rake bump_version
Copyright 2019 ThoughtWorks, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.