Hello,
I am looking into the preferred way how to make references to external
resources. So far, I have used separate section with itemizedlist, very much like:
https://docs.fedoraproject.org/en-US/index.html
Downside is that references are attached to the whole section. In case I want to
refer to external resource from the text, I could use footnotes like in:
https://docs.fedoraproject.org/en-US/Fedora/19/html/Security_Guide/chap-Security_Guide-Security_Overview.html
These are barely visible and don`t work well in text - see footnote [1] or [2]
in Security Guide above.
The only other way I can now think of is to verbosely refer to external
resources, e.g. "... (see RFC 2616)" with ulink to rfc. However, I also like to
keep all relevant references together, so I would also update References
section, which works but its not a footnote, so lacks backreference to text.
What is your preferred way to make references ?
Thank you,
Jan
--
docs mailing list
docs@lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs