Issue and Epic Refs in Commits and PRs

Amidst a large and ever-growing volume of changes, connecting work to product roadmap epics via GitHub Issue and Jira Epic references (Issue and Epic Refs) improves the ability to make the connection between product changes and roadmap epics for the docs team, and provides traceability and context for engineers, docs, management, and other departments within the company.

1 Who is the audience for Issue and Epic Refs
2 When to include an Issue or Epic Ref
3 How to write an Issue or Epic Ref
- 3.1 High-level rules
- 3.2 Recommended reference placement
- 3.3 Format
  - 3.3.1 Issue Ref
    - 3.3.1.1 Supported Issue Identifiers
    - 3.3.1.2 Supported Keywords and Key Phrases
    - 3.3.1.3 Examples: