Wiki page template

From DAO Governance Wiki
Jump to navigation Jump to search

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

  1. Top
  2. Middle
  3. 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.

Notes & References