diff options
author | Emily Shaffer <emilyshaffer@google.com> | 2019-05-17 12:07:04 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2019-05-19 11:01:24 +0900 |
commit | 5ef811ac5d60f9f6aa4300606d85ff780d2f402a (patch) | |
tree | 19ed43a5c584f44265d0268ab65bf32627463029 /trace2/tr2_cmd_name.h | |
parent | documentation: add tutorial for first contribution (diff) | |
download | tgif-5ef811ac5d60f9f6aa4300606d85ff780d2f402a.tar.xz |
documentation: add anchors to MyFirstContribution
During the course of review for MyFirstContribution.txt, the suggestion
came up to include anchors to make it easier for veteran contributors to
link specific sections of this documents to newbies. To make life easier
for reviewers, add these anchors in their own commit. See review context
here: https://public-inbox.org/git/20190507195938.GD220818@google.com/
AsciiDoc does not support :sectanchors: and the anchors are not
discoverable, but they are referenceable. So a link to
"foo.com/MyFirstContribution.html#prerequisites" will still work if that
file was generated with AsciiDoc. The inclusion of :sectanchors: does
not create warnings or errors while compiling directly with `asciidoc -b
html5 Documentation/MyFirstContribution.txt` or while compiling with
`make doc`.
AsciiDoctor does support :sectanchors: and displays a paragraph link on
mouseover. When the anchor is included above or inline with a section
(as in this change), the link provided points to the custom ID contained
within [[]] instead of to an autogenerated ID. Practically speaking,
this means we have .../MyFirstContribution.html#summary instead of
.../MyFirstContribution.html#_summary. In addition to being prettier,
the custom IDs also enable anchor linking to work with
asciidoc-generated pages. This change compiles with no warnings using
`asciidoctor -b html5 Documentation/MyFirstContribution.txt`.
Signed-off-by: Emily Shaffer <emilyshaffer@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'trace2/tr2_cmd_name.h')
0 files changed, 0 insertions, 0 deletions