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