docs/ci-integration/guides/guide-template.md
The headers in this document provide a skeleton to fill in when adding documentation for a new CI platform. This section should include an overview of how Earthly might fit into this CI. If the CI offers multiple modes, we should mention them even if they are not all documented.
It should include any relevant compatibility information, such as versions of plugins or runtimes.
It should also include links to the CI systems relevant documentation for setup and configuration.
This section should contain all special tweaks needed that are different than the ones detailed in overview. If there are different tweaks for different modes, then each mode should have its own Setup header.
Any special dependencies needed for this CI, w.r.t. Earthly. Probably a rare section.
Any special installation instructions needed for this CI, w.r.t. Earthly. Special configuration or example targets for configuring a container-based CI would go here.
Most common section. Any special, or recommended configuration (for Earthly or dependencies) for this CI.
Any extra notes regarding the CI that aren't per-setup-section.
{% hint style='danger' %}
This example is not production ready, and is intended to showcase configuration needed to get Earthly off the ground. If you run into any issues, or need help, don't hesitate to reach out!
{% endhint %}
This should walk through (and/or link to) an example using Earthly with this CI.
Commentary on the example to make it production ready.