This is where you will find the source for the Concourse website and overall documentation. All of our docs are written using the Booklit documentation engine.
Table of Contents
Building the Docs Locally
Have Go v1.11.2+ installed and configured. You can find the relevant instructions for your platform of choice here: Go Getting Started
Clone this repository: https://github.com/concourse/docs
Compiling the Docs
You can compile the Concourse docs by running:
build script will instruct Booklit to compile all the files under
html files. The files will then be dumped into your current working
directory, i.e. the root of this repo.
Viewing the docs in your browser
To run a server that will rebuild the docs as needed, pass
-s (port) like so:
./scripts/build -s 8000
You will be now be able to see the rendered site if you navigate to http://localhost:8000.
You can find all of the styling assets for the Concourse website and documentation under the
If you are planning to make changes to the site,
css/booklit.css is usually a good place to start.
All of the website content can be found under the
lit/ folder of this repository.
The content layout for the site is qute simple, and for the most part self-explanatory. If you want to change a specific page on the website you can usually jump straight to it by looking for the
.lit version of the page. For example you can make changes to https://concourse-ci.org/fly.html by editing
html/docs-header.tmplL1 navigation header for the Concourse website and docs.
lit/index.htmlThe Concourse Homepage
lit/reference/This is where you'll find most of the documentation listed under https://concourse-ci.org/reference.html
lit/release-notes/Release notes separated by Concourse version. These
.litsnippets are ultimately loaded into
lit/download.lit/Concourse Downloads page
lit/docs/resource-types/community-resources.litA listing of Concourse community-supported resources
Updating the Blog Theme
$ make blog/concourse.zip # and then upload it in the Ghost admin UI