ToC note (still is Re: Wiki page structure [RFC])
Karsten Wade
kwade at redhat.com
Sun Dec 10 16:23:37 UTC 2006
I forgot to mention that in these guidelines, I added a requirement for
a [[TableOfContents]] macro at the start of every page.
There may be disagreement here. My reasons for making this a rule are:
* It is common practice and is not confusing to people
* Common in other Wiki (such as MediaWiki), so it is somewhat expected
* Easy to reproduce in XML with a <toc> in each <chapter>
* It really makes for a better reader experience
There are exceptions to most rules I wrote down, so please read the
page:
> http://fedoraproject.org/wiki/WikiEditing#Structure_of_a_Wiki_Page
Before commenting here. :)
thx - Karsten
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-websites-list/attachments/20061210/7eabc260/attachment.sig>
More information about the Fedora-websites-list
mailing list