kba/hocr-spec

Rendering of internal links

Closed this issue · 2 comments

Is it possible to render the internal links in the html without the paragraph signs and section numbers? I feel that the readability suffers from this, e.g.

hocr-spec-links

Would you agree?

kba commented

Yeah, it's not perfect right now. Linking to generic headlines isn't ideal anyway, but there's lots of options in bikeshed for linking, see https://github.com/tabatkins/bikeshed/blob/master/docs/dfn-contract.md and https://github.com/tabatkins/bikeshed/blob/master/docs/markup.md, https://github.com/tabatkins/bikeshed/blob/master/docs/definitions-autolinks.md etc. Want to investigate further, maybe next week or so.

kba commented

This has changed a lot, a cheatsheet how we reference terms is in #53, bikeshed has easier docs now