Documentation options: Code or not?
- From
- Michael Lyons <git@michael.lyo.nz>
- Date
- Jan 4, 2026, 18:04 UTC
- Message-ID
- <2076768.usQuhbGJ8B@debian-mbp>
I noticed that git-scm.com's documentation for `git-am` has a different color for the rerere options than it does for the other ones. Those options are imported from rerere-options.adoc, which adds code backticks to the keys:
`--rerere-autoupdate`:: `--no-rerere-autoupdate`:: After the rerere mechanism reuses a recorded resolution...
I started a quick commit to drop the backticks from rerere-options, but then sampled a few other doc pages. Some use backticks (git-merge, git-repo), and some don't (git-prune, git-name-rev). Is there a preferred style? Would an update to make them consistent be useful or just annoying?
Thank you, Michael