Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
wiki:editor_notes [2008/11/12 20:12] – preliminary clean-up - to be continued holgerwiki:editor_notes [2012/03/08 06:52] – dWkuUwmXWBYqIqctf 109.230.216.60
Line 1: Line 1:
-====== Notes for Editors ====== +I like your color approach and it would dnfieitely help to resolve some of the problems surrounding wikis. Unfortunately it doesn't help with the problem of updating/maintaining content. I think wikis needs a strong notion of ownership and in addition to that people, willing to contribute/update and maintain the stuff that they produce. If those requirements are not met it will end up being a pile of meaningless pages and links. I've been there myself. If I don't feel responsible for the stuff I produce, I'll never come back and update/maintain it.
- +
-Editing page content is easy. Please follow the notes above the edit-toolbar (when editing a page) to get you started with dokuwiki. +
- +
-Most entries are still barebone **meta**-information (only visible in box or index) with little extras, or few comments.  +
- +
-It should be straight forward to fill in or update meta-tags like //screenshot//, //link//, //author//, etc. and extend the wiki-page with information.  +
- +
-The meta-tag //releasedate// should contain the release date of the latest version for a project or the date of the last update for a document (e. g. an online article).  Recommended format is yyyy-mm-dd (e. g. 2008-11-31). Please add this information to give other users a hint on how old a specific information/app is. +
- +
-Re-assigning **tags** is not as easy as we would like to have! At the moment new categories are generated by using a new tag in any wiki page.  +
- +
-The category page corresponding to a tag is **not** automatically generated, but has a generate-template (just click create and save). - look up [[:apps:index|existing category tags]] and extend this list by hand editing after inventing new tags! (this last step will soon be automated.) +
- +
-===== Meta-Information ===== +
- +
-  * there is a template of meta-information that we'd like you to fill in and the wiki page can extend as needed. +
- +
-  * each meta entry is unique (eg. there can be only one ''screenshot'' per entry.)! It is used to classify entries and provide specific layout independant information. +
- +
-===== Tags ===== +
- +
-Tags are use for navigation, link-structure and feature-display +
- +
-Assigning tags is still tricky +
- +
-  * every entry can have multiple tags (space separated).  +
-  * cut and paste [[:apps:index|category]] names (feel free to add tags not listed there if you see a need for them) +
-  * use underscores within one tag, use space to separates tags +
-  * there are some tags which indicate specific features of an application: +
-     * [[apps:categories:jack|JACK]]: JACK-support +
-     * [[apps:categories:JACK_Transport|JACK_Transport]]: support for JACK Midi-Transport +
-     * [[apps:categories:JACK_MIDI|JACK_MIDI]]: support for the JACK Midi Interface +
-     * [[apps:categories:DSSI|DSSI]] +
-     * [[apps:categories:LV2|LV2]] +
-     * [[apps:categories:LADSPA|LADSPA]] +
-     * [[apps:categories:Multitrack|Multitrack]] +
-     * etc. +
- +
-===== Creating new entries ===== +
- +
-==== Bookmarklet - the easy way ==== +
- +
-There is the possibility to use [[site:bookmarklet|this bookmarklet]] to submit new apps more comfortably. +
- +
-==== Manual approach ==== +
- +
-  * All applications or projects have their own wiki page in ''/apps:all:''//name// +
-  * choose a name for the application +
-  * visit the ''/apps:all:''//name// directly (e. g. [[http://apps.linuxaudio.org/apps/all/nonexistant_page]]) +
-  * edit the page to create it - we have a button for that, too: +
-{{NEWPAGE>apps:all|newpagetemplate=:site:lappstemplate&newpagevars=@TAG@,new}} +
-  * add tags and meta information as described above +
- +
-===== Deleting entries ===== +
- +
-Clear the page to delete it, but consider a redirect if: +
-  * the page could be referenced by other pages +
-  * the page name is an alternative name or shortcut for a project (e. g. clm for Common Lisp Music) +
- +
-===== Redirecting pages ===== +
- +
-Clear the page (particularly the tags section could cause confusion) and add: +
- +
-  ~~REDIRECT>namespace:page~~ +
- +
-E. g. you'd like to redirect "apps:all:sc3" to "apps:all:supercollider": +
- +
-  ~~REDIRECT>apps:all:supercollider~~ +
- +
- +
-===== Comments on specific entries ===== +
- +
-We are considering to use dokuwiki also for comments and blogging, but until we decide so, we encourage to add comments directly to a wiki page under an appropriate heading at the bottom. +
- +
-use the [[:wiki:start|wiki]] for suggestions or join discussion about ongoing work there. +
wiki/editor_notes.txt · Last modified: 2013/06/02 15:45 by 127.0.0.1