evergreen-docs:dig_style_guide
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
evergreen-docs:dig_style_guide [2021/10/27 15:50] – [Screenshots] jpringle | evergreen-docs:dig_style_guide [2023/06/01 12:22] (current) – update branch name from master to main gmcharlton | ||
---|---|---|---|
Line 67: | Line 67: | ||
===== General ===== | ===== General ===== | ||
* **Avoid changing section titles**. These are used to auto-generate anchor tags which are often used for links. Change with care, and check for links in other docs. | * **Avoid changing section titles**. These are used to auto-generate anchor tags which are often used for links. Change with care, and check for links in other docs. | ||
- | * Always **review changes** before committing to master | + | * Always **review changes** before committing to main (and check the updated web page the next day to make sure it worked right). |
- | * Always use **spell-check** on new content (including when porting old docs into master). | + | * Always use **spell-check** on new content (including when porting old docs into main). |
* AsciiDoc code lines should be 80 characters long or shorter. (Occasionally, | * AsciiDoc code lines should be 80 characters long or shorter. (Occasionally, | ||
* Screenshots should be smaller than 1050 pixels wide (when possible). | * Screenshots should be smaller than 1050 pixels wide (when possible). | ||
+ | * Rather than recreating documentation text in multiple adoc files, instead link directly to the main adoc for the feature. | ||
===== Formatting ===== | ===== Formatting ===== | ||
==== Headers ==== | ==== Headers ==== |
evergreen-docs/dig_style_guide.txt · Last modified: 2023/06/01 12:22 by gmcharlton