doc:templates

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
doc:templates [2026/04/13 16:34] – [Template for topic pages] Simon Grantdoc:templates [2026/04/13 18:28] (current) – [Template for concepts] Simon Grant
Line 4: Line 4:
  
 A template is a way to give a kind of scaffolding — in this case, suggesting the elements that we think work well in a page. It helps both writers and readers: A template is a way to give a kind of scaffolding — in this case, suggesting the elements that we think work well in a page. It helps both writers and readers:
-  * for writers, it gives a good idea of how to structure a page+  * for writers, it gives a good idea of how to structure a page;
   * for readers, it gives more consistency, so they know what to expect and therefore can read and understand more easily.   * for readers, it gives more consistency, so they know what to expect and therefore can read and understand more easily.
  
-Templates are useful guides, but are not written in stone. They can be changed when needed, though to maintain consistency and readability, we want these to be changed by agreement rather than by individuals. Individuals can always change any page they create or edit in any case, so they don't need to change the templates.+Templates are useful guides, but are not written in stone. They can be changed when needed, though to maintain consistency and readability, we want these to be changed by agreement rather than by individuals. Individuals can always change any page they create or edit in any case, so they don't need to change the templates. When needed, we will update the templates after general consultation.
  
 Here are outlines of the page templates we either have or are working on. Here are outlines of the page templates we either have or are working on.
Line 16: Line 16:
   * Curator's name   * Curator's name
   * A photo, or other graphic   * A photo, or other graphic
-  * About: any short bio, and/or links to other pages with publicly available information +  * About: any short bio, and/or links to other pages with publicly available information, recommended to include 
-  * Organisation(s) +    * links to the topics on this wiki curated by this curator 
-  * Contact details+    * and any other relevant writings 
 +    * any chosen relevant social media presence (e.g. LinkedIn) 
 +  * Organisation(s), and roles within them 
 +  * Whichever contact details are reliable and suit the curator
  
 We want curators, particularly on their public home pages, to be free to represent themselves as they see best. The above are just guidelines. We want curators, particularly on their public home pages, to be free to represent themselves as they see best. The above are just guidelines.
Line 27: Line 30:
  
   * A link to the topic group(s) this topic belongs to.   * A link to the topic group(s) this topic belongs to.
-  * Topic title +  * Topic title, with: 
-    * Main graphic representing the topic, with optional caption +    * main graphic representing the topic, with optional caption 
-    * Lead quotation, for inspiration, with source+    * lead quotation, for inspiration, with source
   * Main section, that can include, for example   * Main section, that can include, for example
-    * The meaning of this topic +    * the meaning of this topic 
-    * Rationale; why; benefits, etc. +    * rationale; why; benefits, etc. 
-    * What can a reader do around this topic +    * what can a reader do around this topic 
-  * Links: +  * Links:
     * to the forum section, for public exchanges     * to the forum section, for public exchanges
     * to other sites, as further resources     * to other sites, as further resources
     * to other related topics in this wiki     * to other related topics in this wiki
-    * to any sub-pages for this topic +    * to any sub-pages for this topic (only if they exist) 
-    * to key concept pages+    * to key concept pages (optional, may be linked from the main text)
   * Commentary: where individual curators can add their personal perspectives, opinions, links, being respectfully open about any diversity of views on the topic   * Commentary: where individual curators can add their personal perspectives, opinions, links, being respectfully open about any diversity of views on the topic
-  * Open questions: where curators together can formulate questions that point to possible areas, for further investigation, or to grow the knowledge base+  * Open questions: where curators together can formulate questions that point to possible areas, for further investigation, and to grow the knowledge base
   * A list of the curators who are actively maintaining this page   * A list of the curators who are actively maintaining this page
 +    * with links to their home pages on our wiki
  
-For a more detailed explanation, please see the +For a more detailed explanation, please see the annotated [[template for topics]]. 
 + 
 +===== Template for concepts ===== 
 + 
 +To come. 
 + 
 +===== Template for groups ===== 
 + 
 +To come. 
 +===== Related topics ===== 
 + 
 +See the DokuWiki documentation on [[doku>namespace_templates]].
  • doc/templates.1776098097.txt.gz
  • Last modified: 2026/04/13 16:34
  • by Simon Grant