Using code samples
-
Provide code examples to help with clarity, and to help the reader reproduce the subject matter.
-
CircleCI config should always be tested as valid before adding it to docs.
-
A reader should be able to copy and paste code snippets, and have them work with only minimal changes.
-
When using example code snippets, be mindful that people are likely to copy paste them. Always point out if any items or values need to be replaced with the reader’s own data, including whether they should replace the surrounding
< >
or“ “
. -
When a reader needs to substitute some of their own data into a snippet or command, use
< >
, for example,<my-data>
.
Help make this document better
This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.
- Suggest an edit to this page (please read the contributing guidefirst).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
Need support?
Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.
You can also visit our support site to find support articles, community forums, and training resources.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.