Guidelines for all images
Ensure all images have descriptive alternative text. For example, in asciidoc:
.Image Title image::name-of-image.png[Alternative text to describe the image, including, if possible any text in the image itself]
If you’re adding a screenshot, make it easier to see and help consistency across docs by sticking it in here: https://browserframe.com/. Choose Generic Light and drag and drop your screenshot into the window, then download and you will get a PNG.
When creating screenshots use a browser extension or similar to resize the window to 1440x900. For example, Chrome Window Resizer.
If taking a screenshot of the CircleCI app include the sidebar menu so the reader can see what page you are on.
Think about how clear the location of your screenshot is for unfamiliar users. It is best to include the full width of the screen, if possible, so the location of what you are drawing attention to is clear. An image of a button with no wider reference can be confusing.
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 guide first).
- 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.
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.