doc:starting_a_new_topic [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]]//

====== Procedure for starting a new topic ======

This starts when we have at least one confirmed curator, preferably two or more.\\
The “wiki team” is currently [[user:Katja]] and [[user:asimong|Simon]], and we consult overall with [[user:Dave]] and others.
  - Be clear about the topic you want to start, and that it isn’t dealt with adequately within existing topics.
  - Decide on the page name that will be displayed to readers, to minimise confusion and maximise recognition.
    - Best to consult with our wiki team to ensure it makes sense globally.
  - Consult on a version of this name that will be used as the internal page name, and for URL purposes.
    - The internal page name is all lower-case, and spaces are replaced with underscores
    - But when you create a link to it, you can use mixed case and spaces
  - Consult with the wiki team to agree on a four-letter abbreviation for the namespace and user group.
  - Consult around which group(s) of topics it should best belong to. One group is ideal; 2 is OK occasionally; max 3.
    - take a look at our [[https://docs.google.com/spreadsheets/d/1U42B3-Vs65vBDdMkkCKE1uaugZva4KnL5m1nzsGyL6E/edit?gid=1786836144#gid=1786836144|groups and new topics tab]] to see if we have already imagined something close

Before you go on, the wiki team needs to create the namespace and the user group, and add you to that user group, so you will be able to create the topic page and then edit it.
  - Create the page…
    - there are several ways to do this
      - go to any existing page, and replace the namespace and page name with the new one
      - OR, create a link to the new page in your own space (or even the playground) and then clink on the red link
      - OR get us to do that for you ;-)
    - edit, as needed, the provided template (which will appear automatically)
      - check / edit the displayed name of the page
      - at the top of the page, put in the correct groups for the topic
      - you can look at the annotated [[template for topics]] to clarify the structure we suggest
    - Find a suitable image (photo or graphic) for the topic, with width:height at the ratio exactly 4:3
      - While you are on the new page, open the Media Manager (in the Spanner menu)
      - Upload your photo in the Media Manager, similarly to all the other topic pages
      - Check it works on the actual page!
  - When you have done all that, let the wiki team know, so that we can
    - copy the image into the “wiki:” space so that our picture-grid menus aren’t vulnerable
    - add your new topic to the display of topics in the group (or groups) you suggest

----

==== This is what the wiki admin team need to do: ====
  - Create e.g. a "start" page in the new namespace — this action actually creates the namespace
    - after the topic page is created, this page may be deleted, but not until then!
  - Under Admin→Access Control List Management
    - at the top, after “Permissions for” select “Group”
    - type in the same 4-letter abbreviation into the box and click “Select”; “Add new entry” appears
    - select the radio button to the left of “Upload”; click “Save”
    - The new permission should appear in the list below, like most of the other topic permissions
  - Under Admin→User Manager
    - add the new user group to the list of groups that the creator-curator belongs to

Then let the curator know that they can proceed.\\
When the page is created, several things need to be done off the wiki, in the Categories/groupings spreadsheet, so that we can keep track of everything…
  - Add details to columns C,D,E,F of the [[https://docs.google.com/spreadsheets/d/1U42B3-Vs65vBDdMkkCKE1uaugZva4KnL5m1nzsGyL6E/edit?gid=1421540111#gid=1421540111|For wiki tab]]
  - Similarly, add to the tab [[https://docs.google.com/spreadsheets/d/1U42B3-Vs65vBDdMkkCKE1uaugZva4KnL5m1nzsGyL6E/edit?gid=2096207749#gid=2096207749|TOPICS LIST CATS]]
  - Add where possible to the tab [[https://docs.google.com/spreadsheets/d/1U42B3-Vs65vBDdMkkCKE1uaugZva4KnL5m1nzsGyL6E/edit?gid=1354477135#gid=1354477135|Topics & Curators]]

Finally, go ahead with your curator team and fill in an attractive, informative topic page!