Wiki page template
This is the self-referential template for typical pages in the DGF wiki. This top section gives a brief introduction to the subject. Pages are broken down into three parts
- Top
- Middle
- Bottom
The top section is the brief intro to the subject that is a brief overview of the entire subject. It invites the reader to move into the subject.
The middle section of a page is the main body. It contains all the relevant details of the subject. It should be designed to make it easy for the reader to navigate through the most important ideas in the subject.
The bottom section of a page contains outros to the page. This information contains links to leave the subject (other pages in the wiki or links away from the wiki) or snippets that definitively conclude a topic.
The next three sections in this Wiki page template are the main body of the page.
Background/Overview
The page then has a more extended discussion on the subject from a high-level. Think of this section as marketing for and history of the subject. It should include all the past understanding and conclusions on the subject, but not the thinking behind it--that's for the next section.
Theory/Mechanism/System design
More rigorous and detailed discussion follows. This section explains the reasons for why the subject has been developed.
In the DGF wiki, we link the first mention of a concept with its own page, but not subsequent mentions. (For example, the term "DGF wiki" in this page follows this convention.)
Applications
In this section we detail the uses of the subject of the page. Each application will have a subheading as follows
First application
Main page: First application
Typically these uses are too complicated to completely describe in this page so there will be a link to the main page (as shown above in italics) followed by a summary, here.
Second application
Main page: Second application
This is the end of the main body.
The following sections are bottom matter for the page, outro.
Math
Links to details justifying the conclusions of the main body.
Code
Links to details implementing the conclusions of the main body.
Downloads
Links to working applications that incorporate the code.
See Also
- Proposals for important changes in the subject are usually given in the Discussion page. Just click on "Discussion" at the top of the page.