docs(repo): add technical writing guide
This commit is contained in:
@@ -3,9 +3,14 @@
|
||||
## Commit convention
|
||||
|
||||
Use Conventional Commits for all commit messages.
|
||||
Before writing a commit message, please read [[docs/conventional-commits]].
|
||||
Before writing a commit message, read `docs/conventional-commits.md`.
|
||||
Do not add agent attribution or co-author trailers.
|
||||
|
||||
## Technical writing
|
||||
|
||||
Use `docs/technical-writing.md` and `docs/dictionary.md` for authored prose.
|
||||
Use the nearest project dictionary for project-specific domain language.
|
||||
|
||||
## Gotchas
|
||||
|
||||
- When materializing an external specification, standard, or project-maintained convention, use the upstream source instead of reconstructing it from memory.
|
||||
|
||||
Reference in New Issue
Block a user