Author style guide: Difference between revisions
(Created page with "== Design Considerations == Wiki self-similar design leads to better # Understanding/navigation/learning # Quicker Wiki development # More convergent vision of the document, so it helps resolve debates. Goal is to build an accurate, useful, and attractive document. --We following most of the conventions on Wikipedia. For example, each time a term is used for the first time on a page, it is linked to the page/section that defines it. The second and later time it is...") |
m (Craig Calcaterra moved page DGF Wiki Author Style Guide to Author Style Guide) |
(No difference)
|
Revision as of 08:53, 26 February 2023
Design Considerations
Wiki self-similar design leads to better
- Understanding/navigation/learning
- Quicker Wiki development
- More convergent vision of the document, so it helps resolve debates.
Goal is to build an accurate, useful, and attractive document.
--We following most of the conventions on Wikipedia. For example, each time a term is used for the first time on a page, it is linked to the page/section that defines it. The second and later time it is used, there is no link. We follow Wikipedia’s style guide for three reasons. First, out of respect for the best decentralized organization ever created. Second, because people have already trained themselves how to navigate the pages. Third, if we have an improvement, we should first try to convince Wikipedia to change.
Page Structure
This is the archetypical design for organizing the content in each page on the DGF Wiki.
Top: Outline
Links to sections
Bottom: links to
- Mathematical formulas relevant to this page
- code related to this page
- outside references
- page references
Bottom Bottom: smaller font grey
Members; Contributors’ Guide (links to: [Transcendental Values; this Page Style Guide; conflict resolution protocols [taken from Wikipedia to start]; … ]
Body
Split into 3sections:
1. Overview/current conclusions on the subject.
Info storage, current judgements, perceptions
2. Why?/theory/legislation/thought/info processing
How we got here. Why it's right. Where we're going.
3. Execution/transmission/action
Applications
Each of these subjects can be further broken down into subsections along the same lines. If necessary, within the page, but preferably in a link.