Documentation for CircleCI.
This is the public repository for CircleCI Docs, a static website generated by Jekyll. If you find any errors in our docs or have suggestions, please follow our Contributing Guide to submit an issue or pull request.
For minor changes like typos, you can click Suggest an edit to this page, located at the bottom of each article. This will take you to the source file on GitHub, where you can submit a pull request for your change through the UI.
For larger edits or new articles, you'll want to set up a local environment for editing. Please see our Local Development document to set that up.
If you have a question or need help debugging, please head to CircleCI Discuss where our support team will help you out.
This repository houses and manages several arms of documentation for CircleCI. This section will provide a brief overview of each "component" and how to get started with making changes.
/Jekyll- Main Site
This is the main CircleCI documentation site. This is built with Jekyll and houses the majority of our documentation. Other branches of documentation (
src-crg, etc) eventually get moved into this folder (in our build process) and integrated into the Jekyll Site. Follow the local development guide to get started with building the Jekyll site.
/src-api- API v1.1 and v2 Build Tooling
Our API documentation source can be found in this folder.
API v1 is written by hand, and compiled to work with Slate. The compilation and deployment of
v1is handled by our
.circleci/config.yml, which calls our
build_api_docsscript. If you need to make changes to our V1 documentation, go to
src-api/source/includesand make changes as needed in the markdown files.
.circleci/config.yml. If you need to make changes to the output site, you will likely need to make source code changes to the API, where the docs are generated from.
This is the build folder we use for automatically generating documentation for the CircleCI API v2. This uses Slate and Widdershins to create documentation with a spec (that follows the Open API Spec) generated from the CircleCI code base.
/src-config-builder- Configuration Builder
The configuration builder is a small React application that providers users with a basic configuration builder that they can access through our documentation. When it is deployed, the compiled site is moved into
/src-crg- Configuration Reference
This is documentation for the 2.1 configuration keys, built with Slate and compiled and moved into the Jekyll site.
/src-shared- Shared Assets with circleci.com
This is a git sub-module for shared content with the main CircleCI website. The
Docs for CircleCI Server Administration are built in a slightly different way; please refer to the server build documentation
Documentation (guides, references, and associated images) is licensed as Creative Commons Attribution-NonCommercial-ShareAlike CC BY-NC-SA. The full license can be found here, and the human-readable summary here.
Everything in this repository not covered above is licensed under the included MIT license.