Difference between revisions of "WikiDocs Page"

From MusicBrainz Wiki
(updated HowToContribute (Imported from MoinMoin))
(updated wikinames, stati (Imported from MoinMoin))
Line 37: Line 37:
 
|  Privacy  ||  [http://musicbrainz.org/privacy http://musicbrainz.org/privacy] which redirects to [http://musicbrainz.org/docs/20050213-1.html http://musicbrainz.org/docs/20050213-1.html]  ||  [[Moderator Privacy|ModeratorPrivacy]]  ||  The [[Wiki Page|WikiPage]] contains some discussion but not the content of the current static page. There is no /wd/ page. [[User:Dupuy|Dupuy]] Proposed to leave this as a static page, this is a contract with our users after all.  ||  decide  ||  {o} {o} {o}  
 
|  Privacy  ||  [http://musicbrainz.org/privacy http://musicbrainz.org/privacy] which redirects to [http://musicbrainz.org/docs/20050213-1.html http://musicbrainz.org/docs/20050213-1.html]  ||  [[Moderator Privacy|ModeratorPrivacy]]  ||  The [[Wiki Page|WikiPage]] contains some discussion but not the content of the current static page. There is no /wd/ page. [[User:Dupuy|Dupuy]] Proposed to leave this as a static page, this is a contract with our users after all.  ||  decide  ||  {o} {o} {o}  
 
|-
 
|-
|  History  ||  [http://musicbrainz.org/wd/MusicBrainzHistory http://musicbrainz.org/wd/MusicBrainzHistory]  ||  [[MusicBrainz Roots|MusicBrainzRoots]]  ||    ||  review [[Wiki Page|WikiPage]] and  intertwingle ||  {*} {*} {o}  
+
|  History  ||  [http://musicbrainz.org/wd/MusicBrainzHistory http://musicbrainz.org/wd/MusicBrainzHistory]  ||  [[MusicBrainz History|MusicBrainzHistory]]  ||    ||  done. ||  {*} {*} {o}  
 
|-
 
|-
|  People  ||  [http://musicbrainz.org/wd/MusicBrainzBio http://musicbrainz.org/wd/MusicBrainzBio]  ||  [[People Behind MusicBrainz|PeopleBehindMusicBrainz]]  ||  We need to decide whether to use one single page or inclusions to [[Official Bio|OfficialBio]] [[Sub Page|SubPage]]<code><nowiki></nowiki></code>s in the wiki.  ||  do page and intertwingle ||  {*} {*} {o}  
+
|  People  ||  [http://musicbrainz.org/wd/MusicBrainzBio http://musicbrainz.org/wd/MusicBrainzBio]  ||  [[User:MusicBrainzBio|MusicBrainzBio]]  ||  We need to decide whether to use one single page or inclusions to OfficialBio SubPages in the wiki.  ||  Solved using brief summaries, with links to /OfficialBio subpages. done. ||  {*} {*} {o}  
 
|-
 
|-
|  Licenses  ||  [http://musicbrainz.org/about/licenses.html http://musicbrainz.org/about/licenses.html]  ||  [[MusicBrainz License|MusicBrainzLicense]] or [[Data License|DataLicense]]  ||  Is that a good [[Wiki Name|WikiName]]? Should that be a [[Wiki Page|WikiPage]] at all? See Privacy.   ||  copy content from html and intertwingle ||  {o} {o} {o}  
+
|  Licenses  ||  [http://musicbrainz.org/about/licenses.html http://musicbrainz.org/about/licenses.html]  ||  [[MusicBrainz License|MusicBrainzLicense]]  ||  create page, intertwingle   ||  done. ||  {o} {o} {o}  
 
|-
 
|-
|  Social Contract  ||  [http://musicbrainz.org/contract.html http://musicbrainz.org/contract.html]  ||  [[Social Contract|SocialContract]]  ||  Same situation as ''Privacy'' above ||  decide ||  {o} {o} {o}  
+
|  Social Contract  ||  [http://musicbrainz.org/contract.html http://musicbrainz.org/contract.html]  ||  [[Social Contract|SocialContract]]  ||  create page, intertwingle ||  done. ||  {o} {o} {o}  
 
|-
 
|-
|  Software  ||  [http://musicbrainz.org/wd/MusicBrainzEnabledApplications http://musicbrainz.org/wd/MusicBrainzEnabledApplications]  ||  none yet   ||  [[Other Programs|OtherPrograms]] would be analog to [[Other Databases|OtherDatabases]], but is not ideal. [[MusicBrainz Client|MusicBrainzClient]] is better, but currently redirects to [[Client Library|ClientLibrary]]  ||  create new [[Wiki Page|WikiPage]], copy content, intertwingle  ||  {*} {*} {o}  
+
|  Software  ||  [http://musicbrainz.org/wd/MusicBrainzEnabledApplications http://musicbrainz.org/wd/MusicBrainzEnabledApplications]  ||  [[MusicBrainz Enabled Applications|MusicBrainzEnabledApplications]]   ||  [[Other Programs|OtherPrograms]] would be analog to [[Other Databases|OtherDatabases]], but is not ideal. [[MusicBrainz Client|MusicBrainzClient]] is better, but currently redirects to [[Client Library|ClientLibrary]]  ||  create new [[Wiki Page|WikiPage]], copy content, intertwingle  ||  {*} {*} {o}  
 
|-
 
|-
 
|  Logos  ||  [http://musicbrainz.org/about/logos.html http://musicbrainz.org/about/logos.html]  ||  none  ||  not really important, IMO  ||  ||  {o} {o} {o}  
 
|  Logos  ||  [http://musicbrainz.org/about/logos.html http://musicbrainz.org/about/logos.html]  ||  none  ||  not really important, IMO  ||  ||  {o} {o} {o}  
Line 51: Line 51:
 
|  Statistics  ||  [http://musicbrainz.org/about/stats.html http://musicbrainz.org/about/stats.html]  ||  [[MusicBrainz Statistics|MusicBrainzStatistics]] ?  ||  A wikipage that ''lists'' all available stats would be good  ||  create [[Wiki Page|WikiPage]] and intertwingle  ||  {*} {o} {o}  
 
|  Statistics  ||  [http://musicbrainz.org/about/stats.html http://musicbrainz.org/about/stats.html]  ||  [[MusicBrainz Statistics|MusicBrainzStatistics]] ?  ||  A wikipage that ''lists'' all available stats would be good  ||  create [[Wiki Page|WikiPage]] and intertwingle  ||  {*} {o} {o}  
 
|-
 
|-
|  Mirrors  ||  [http://musicbrainz.org/about/mirrors.html http://musicbrainz.org/about/mirrors.html]  ||  [[MusicBrainz Mirror|MusicBrainzMirror]]  ||  since this has descriptive text, which is bound to change, that would be good ||  create [[Wiki Page|WikiPage]] and intertwingle ||  {*} {o} {o}  
+
|  Mirrors  ||  [http://musicbrainz.org/about/mirrors.html http://musicbrainz.org/about/mirrors.html]  ||  [[Mirror Server|MirrorServer]]  ||  - ||  done. ||  {*} {o} {o}  
 
|-
 
|-
 
|  Elections  ||  [http://musicbrainz.org/user/election/ http://musicbrainz.org/user/election/]  ||  none  ||  Automatically generated page cannot be wikified  ||  leave it  ||  {o} {o} {o}  
 
|  Elections  ||  [http://musicbrainz.org/user/election/ http://musicbrainz.org/user/election/]  ||  none  ||  Automatically generated page cannot be wikified  ||  leave it  ||  {o} {o} {o}  
Line 67: Line 67:
 
|  '''Download'''  
 
|  '''Download'''  
 
|-
 
|-
|  Download  ||  [http://musicbrainz.org/download.html http://musicbrainz.org/download.html]  ||  [[Available Download|AvailableDownload]]<code><nowiki></nowiki></code>s or [[MusicBrainz Download|MusicBrainzDownload]]<code><nowiki></nowiki></code>s ? ||  That should list the available datadumps too, IMO ||    ||  {*} {*} {o}  
+
|  Download  ||  [http://musicbrainz.org/download.html http://musicbrainz.org/download.html]  ||  [[Products]]  ||  done. ||    ||  {*} {*} {o}  
 
|-
 
|-
|  [[MusicBrainz]] Tagger  ||  [http://musicbrainz.org/tagger/index.html http://musicbrainz.org/tagger/index.html]  ||  [[MusicBrainz Tagger|MusicBrainzTagger]]  ||  seems to be more or less the same ||  review page ||  {*} {*} {*}  
+
|  [[MusicBrainz]] Tagger  ||  [http://musicbrainz.org/tagger/index.html http://musicbrainz.org/tagger/index.html]  ||  [[MusicBrainz Tagger|MusicBrainzTagger]]  ||  - ||  done. ||  {*} {*} {*}  
 
|-
 
|-
 
|  ... more to add (the following is not complete nor ordered anymore)  
 
|  ... more to add (the following is not complete nor ordered anymore)  
Line 93: Line 93:
  
 
* [[MusicBrainz]] or [http://www.musicbrainz.org/wd/AboutMusicBrainz http://www.musicbrainz.org/wd/AboutMusicBrainz]  
 
* [[MusicBrainz]] or [http://www.musicbrainz.org/wd/AboutMusicBrainz http://www.musicbrainz.org/wd/AboutMusicBrainz]  
** [http://www.musicbrainz.org/wd/CorporateSponsors http://www.musicbrainz.org/wd/CorporateSponsors]
 
 
** [[Moderator Privacy|ModeratorPrivacy]] or [http://www.musicbrainz.org/privacy http://www.musicbrainz.org/privacy]  
 
** [[Moderator Privacy|ModeratorPrivacy]] or [http://www.musicbrainz.org/privacy http://www.musicbrainz.org/privacy]  
** [http://www.musicbrainz.org/wd/MusicBrainzHistory http://www.musicbrainz.org/wd/MusicBrainzHistory]
 
 
** People: [http://www.musicbrainz.org/bio.html http://www.musicbrainz.org/bio.html] or Category Person (hmm, how do you do that?)  
 
** People: [http://www.musicbrainz.org/bio.html http://www.musicbrainz.org/bio.html] or Category Person (hmm, how do you do that?)  
** * [[Style Council|StyleCouncil]] or currently [http://www.musicbrainz.org/wd/OfficialStyleGroup http://www.musicbrainz.org/wd/OfficialStyleGroup]
 
 
** A page that summarizes [http://www.musicbrainz.org/about/licenses.html http://www.musicbrainz.org/about/licenses.html] and [http://www.musicbrainz.org/contract.html http://www.musicbrainz.org/contract.html] and perhaps [http://www.musicbrainz.org/about/logos.html http://www.musicbrainz.org/about/logos.html] and the [http://blog.musicbrainz.org/archives/2005/05/questions_about.html very good blog entry by Robert]  
 
** A page that summarizes [http://www.musicbrainz.org/about/licenses.html http://www.musicbrainz.org/about/licenses.html] and [http://www.musicbrainz.org/contract.html http://www.musicbrainz.org/contract.html] and perhaps [http://www.musicbrainz.org/about/logos.html http://www.musicbrainz.org/about/logos.html] and the [http://blog.musicbrainz.org/archives/2005/05/questions_about.html very good blog entry by Robert]  
  

Revision as of 12:03, 20 June 2006

WikiDocs Pages

Attention.png This page lists all wiki pages that should be part of the initial WikiDocs launch and listed in the ModeratedRevisionTable

WikiDocs is curently live on the TestServer only. The Transclusion Table will be migrated to the main server with the next release.

General Issues

To decide which pages nedd to be moderated I ask myself two questions:

  • What pages are relevant to a newcomer to MusicBrainz? These are the pages that should be moderated. Pages that are only relevant to people who are already accustomed to MusicBrainz can stay in the MusicBrainzWiki and do not need to be moderated, since a member of the MusicBrainz community can (or should learn to) retrieve informaiton from the wiki.
  • What pages reflect an official position of the MusicBrainz project? The responsible persons need to have some control over these pages, thus they need to be moderated.

Generally I try to have as few pages in the ModeratedRevisionTable as possible. I think we should start out low. We can always add more pages later if we get problems with spammers and vandals. MoinMoin has an AntiSpamGlobalSolution against the latter.

Migration Guideline

When converting an old static page into a WikiDocs page, make sure, that:

  • The WikiDocs page has a really GoodWikiName. WikiDocs pages cannot be renamed, so you'll have to get it right from the start.
  • Preserve all links: Make sure the new WikiDocs page contains all links that the old static page had. This is important because otherwise you could cut off a part of the documentation.
  • WikiDocsPages must never be renamed. Therefore they should all have the following ACL line:
  • ## DontRenameWikiDocsPages! #acl -All:delete Default

A member of the AdminGroup will have to add this for you.

Pages to Become WikiDocs Pages

Status: I am currently reworking the list into a table that shows which content is where.

Initially I started a semi-structured list with the idea of creating a new MainSiteStructure. But now we first need an overview about the status quo, and the structure created by Keschte is pretty good to start with. See also MusicBrainzDocumentation and even more importantly RestructuringTheDocumentation for some prior work on this (especially proposed WikiNames). This table follows the structure of the new top menu bar:

Position in SiteMenu Current URL Corresponding WikiPage Notes TODO Priority
About
About MusicBrainz http://musicbrainz.org/doc/AboutMusicBrainz AboutMusicBrainz That is the page which hosts the content in question. I have no problems with the WikiName, but Alex once said it was not that good. review WikiPage {*} {*} {*}
Privacy http://musicbrainz.org/privacy which redirects to http://musicbrainz.org/docs/20050213-1.html ModeratorPrivacy The WikiPage contains some discussion but not the content of the current static page. There is no /wd/ page. Dupuy Proposed to leave this as a static page, this is a contract with our users after all. decide {o} {o} {o}
History http://musicbrainz.org/wd/MusicBrainzHistory MusicBrainzHistory done. {*} {*} {o}
People http://musicbrainz.org/wd/MusicBrainzBio MusicBrainzBio We need to decide whether to use one single page or inclusions to OfficialBio SubPages in the wiki. Solved using brief summaries, with links to /OfficialBio subpages. done. {*} {*} {o}
Licenses http://musicbrainz.org/about/licenses.html MusicBrainzLicense create page, intertwingle done. {o} {o} {o}
Social Contract http://musicbrainz.org/contract.html SocialContract create page, intertwingle done. {o} {o} {o}
Software http://musicbrainz.org/wd/MusicBrainzEnabledApplications MusicBrainzEnabledApplications OtherPrograms would be analog to OtherDatabases, but is not ideal. MusicBrainzClient is better, but currently redirects to ClientLibrary create new WikiPage, copy content, intertwingle {*} {*} {o}
Logos http://musicbrainz.org/about/logos.html none not really important, IMO {o} {o} {o}
Statistics http://musicbrainz.org/about/stats.html MusicBrainzStatistics ? A wikipage that lists all available stats would be good create WikiPage and intertwingle {*} {o} {o}
Mirrors http://musicbrainz.org/about/mirrors.html MirrorServer - done. {*} {o} {o}
Elections http://musicbrainz.org/user/election/ none Automatically generated page cannot be wikified leave it {o} {o} {o}
News
General News http://musicbrainz.org/news/index.html none Unwikifiable page {o} {o} {o}
Blog redirects to blog.musicbrainz.org {o} {o} {o}
Server, libmusicbrainz, libtunepimp, MusicBrainz Tagger, Picard http://musicbrainz.org/news/server.html none Unwikifiable pages {o} {o} {o}
In the Press http://musicbrainz.org/wd/MusicBrainzPress MusicBrainzInThePress That should be updated by the community create WikiPage and intertwingle {*} {o} {o}
Download
Download http://musicbrainz.org/download.html Products done. {*} {*} {o}
MusicBrainz Tagger http://musicbrainz.org/tagger/index.html MusicBrainzTagger - done. {*} {*} {*}
... more to add (the following is not complete nor ordered anymore)
Contribute
How to Contribute http://musicbrainz.org/wd/Contribute HowToContribute Pages are roughly equal review page {*} {*} {o}
Development http://musicbrainz.org/development/index.html MusicBrainzDevelopment These two pages are very different. I think the wiki page is not up to date anymore (We're using Trac now). rewrite wiki page and wikify static pages {*} {*} {*}
Avout Editing http://www.musicbrainz.org/mod_intro.html HowEditingWorks Clone of the old page, needs to be massively enhanced enhance {*} {*} {*}

... More to add

  • It is my understanding that very few of the actual documentation needs to be moderated. Ideally those pages that give a structured introduction to all pages which document a certain feature should be moderated, but these actual pages should not. It is enough that the introductory page declares that the rest is maintaned by the wiki community. Only if we experience vandalism, should we add all these pages to the ModeratedRevisionTable --DonRedman * AdvancedRelationships (once this has stabilzed and only if we have troubles with vandals all the subpages) * EditType (but IMO not the edit type pages themeselves) * ... * MusicBrainzTerminology ** probably all pages of Category Terminology