CoreOS Tectonic documentation is released under the Apache 2.0 License, and we welcome contributions. Check out the help-wanted tag in this project's Issues list for good places to start participating.
Submit fixes and additions in the form of GitHub Pull Requests (PRs). The general process is the typical git fork-branch-PR-review-merge cycle:
- Fork this repository into your GitHub account
- Make changes in a topic branch or your fork's
master - Send a Pull Request from that topic branch to coreos/docs
- Maintainers will review the PR and either merge it or make comments
Cognizance of the tribal customs described and linked to below will help get your contributions incorporated with the greatest of ease.
Commit messages follow a format that makes clear what changed and why it changed. The first line of each commit message should clearly state what module or file changed, summarize the change very briefly, and should end, without a period, somewhere short of 70 characters. After a blank line, the body of the commit message should then explain why the change was needed, with lines wrapped at 72 characters wide and sentences normally punctuated. Cite related issues or previous revisions as appropriate. For example:
ignition: Update etcd example to use %m
Make the etcd configuration example use ignition's %m instead of the
ETCD_NAME environment variable. Fixes #123.
This format can be described somewhat more formally as:
<module or file name>: <what changed>
<BLANK LINE>
<why this change was made>
<BLANK LINE>
[<footer>]
Where the optional [<footer>] might include signed-off-by lines and other metadata.
The style guide prescribes the conventions of formatting and English style preferred in CoreOS documentation.