doc:templates [Knowledge Commons]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
//part of the [[start|GtC documentation]]//

====== Templates ======

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 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. When needed, we will update the templates after general consultation.

Here are outlines of the page templates we either have or are working on.

===== Template for curator ("user") home pages =====

The basics here include:
  * Curator's name
  * A photo, or other graphic
  * About: any short bio, and/or links to other pages with publicly available information, recommended to include
    * links to the topics on this wiki curated by this curator
    * 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.

One thing we do ask, though: please do put some effective way of contacting you, especially for other curators of the same pages, so that you can work towards an agreed structure and contents for your topic pages, and hopefully, respond to readers' feedback on the pages you curate.

===== Template for topic pages =====

  * A link to the topic group(s) this topic belongs to.
  * Topic title, with:
    * main graphic representing the topic, with optional caption
    * lead quotation, for inspiration, with source
  * Main section, that can include, for example
    * the meaning of this topic
    * rationale; why; benefits, etc.
    * what can a reader do around this topic
  * Links:
    * to the forum section, for public exchanges
    * to other sites, as further resources
    * to other related topics in this wiki
    * to any sub-pages for this topic (only if they exist)
    * 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
  * 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
    * with links to their home pages on our wiki

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]].