WikiDocs Page: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(WantegPages triage (Imported from MoinMoin))
(update (Imported from MoinMoin))
Line 1: Line 1:
=WikiDocs Pages=
=WikiDocs Pages=


==Purpose==
[[Image:Attention.png]] This page lists all wiki pages that should be part of the initial [[WikiDocs]] launch and listed in the [[Wiki Docs Transclusion Table|WikiDocsTransclusionTable]].

This page lists all wiki pages that should be part of the initial [[WikiDocs]] launch and listed in the [[Wiki Docs Transclusion Table|WikiDocsTransclusionTable]]. This page [[Needs Updating|NeedsUpdating]].


==General Issues==
==General Issues==
Line 31: Line 33:
| About [[MusicBrainz]] || [http://musicbrainz.org/doc/AboutMusicBrainz http://musicbrainz.org/doc/AboutMusicBrainz] || [[About MusicBrainz|AboutMusicBrainz]] || That is the page which hosts the ''content'' in question. I have no problems with the [[Wiki Name|WikiName]], but Alex once said it was not that good. || review [[Wiki Page|WikiPage]] || {*} {*} {*}
| About [[MusicBrainz]] || [http://musicbrainz.org/doc/AboutMusicBrainz http://musicbrainz.org/doc/AboutMusicBrainz] || [[About MusicBrainz|AboutMusicBrainz]] || That is the page which hosts the ''content'' in question. I have no problems with the [[Wiki Name|WikiName]], but Alex once said it was not that good. || review [[Wiki Page|WikiPage]] || {*} {*} {*}
|-
|-
| Mirrors || [http://musicbrainz.org/doc/MirrorServer http://musicbrainz.org/doc/MirrorServer] || [[Mirror Server|MirrorServer]] || - || done. || {*} {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] || [[Editor Privacy|EditorPrivacy]] || 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. Well, [[WikiDocs]] provides a point-in-time freeze, which is as good as any static page (even better, since it allows to update the content without having to mess with server code. therefore i've ported the content to [[MusicBrainz Privacy Policy|MusicBrainzPrivacyPolicy]] || done. What do we do with [[Editor Privacy|EditorPrivacy]]? || {o} {o} {o}
|-
|-
| History || [http://musicbrainz.org/wd/MusicBrainzHistory http://musicbrainz.org/wd/MusicBrainzHistory] || [[MusicBrainz History|MusicBrainzHistory]] || || done. || {*} {*} {o}
| People || [http://musicbrainz.org/doc/MusicBrainzBio http://musicbrainz.org/doc/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}
|-
|-
| 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] || [[Editor Privacy|EditorPrivacy]] || 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. Well, [[WikiDocs]] provides a point-in-time freeze, which is as good as any static page (even better, since it allows to update the content without having to mess with server code. therefore i've ported the content to [[MusicBrainz Privacy Policy|MusicBrainzPrivacyPolicy]] || done (is it?). What do we do with [[Editor Privacy|EditorPrivacy]]? || {o} {o} {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]] || create page, intertwingle || done. || {o} {o} {o}
| History || [http://musicbrainz.org/doc/MusicBrainzHistory http://musicbrainz.org/doc/MusicBrainzHistory] || [[MusicBrainz History|MusicBrainzHistory]] || || done. || {*} {*} {o}
|-
|-
| Social Contract || [http://musicbrainz.org/contract.html http://musicbrainz.org/contract.html] || [[Social Contract|SocialContract]] || create page, intertwingle || done. || {o} {o} {o}
| Licenses || [http://musicbrainz.org/doc/MusicBrainzLicense http://musicbrainz.org/doc/MusicBrainzLicense] || [[MusicBrainz License|MusicBrainzLicense]] || create page, intertwingle || done. || {o} {o} {o}
|-
|-
| Software || [http://musicbrainz.org/wd/MusicBrainzEnabledApplications http://musicbrainz.org/wd/MusicBrainzEnabledApplications] || [[MusicBrainz Enabled Applications|MusicBrainzEnabledApplications]] || create new page, copy content, intertwingle || done, unless I'm wrong -- [[User:murdos|murdos]] || {*} {*} {o}
| Social Contract || [http://musicbrainz.org/doc/SocialContract http://musicbrainz.org/doc/SocialContract] || [[Social Contract|SocialContract]] || create page, intertwingle || done. || {o} {o} {o}
|-
|-
| Logos || [http://musicbrainz.org/about/logos.html http://musicbrainz.org/about/logos.html] || none || not really important, IMO || || {o} {o} {o}
| Statistics || [http://musicbrainz.org/doc/ServerStatistics http://musicbrainz.org/doc/ServerStatistics] || [[Server Statistics|ServerStatistics]] || - || Looks done. -- [[User:dmppanda|dmppanda]] 11:57, 17 April 2007 (UTC) || {*} {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}
| Logos || [http://musicbrainz.org/doc/MusicBrainzLogo http://musicbrainz.org/doc/MusicBrainzLogo] || [[MusicBrainz Logo|MusicBrainzLogo]] || not really important, IMO || done. || {o} {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 59: Line 59:
| Server, libmusicbrainz, libtunepimp, [[MusicBrainz]] Tagger, Picard || [http://musicbrainz.org/news/server.html http://musicbrainz.org/news/server.html] || none || Unwikifiable pages || || {o} {o} {o}
| Server, libmusicbrainz, libtunepimp, [[MusicBrainz]] Tagger, Picard || [http://musicbrainz.org/news/server.html http://musicbrainz.org/news/server.html] || none || Unwikifiable pages || || {o} {o} {o}
|-
|-
| In the Press || [http://musicbrainz.org/wd/MusicBrainzPress http://musicbrainz.org/wd/MusicBrainzPress] || [[MusicBrainz Press|MusicBrainzPress]] || Should be updated by the community || used existing page. done. || {*} {o} {o}
| In the Press || [http://musicbrainz.org/doc/MusicBrainzPress http://musicbrainz.org/doc/MusicBrainzPress] || [[MusicBrainz Press|MusicBrainzPress]] || Should be updated by the community || used existing page. done. || {*} {o} {o}
|-
|-
| '''Download'''
| '''Products'''
|-
|-
| Download || [http://musicbrainz.org/download.html http://musicbrainz.org/download.html] || [[Products]] || done. || || {*} {*} {o}
| Products || [http://musicbrainz.org/doc/Products http://musicbrainz.org/doc/Products] || [[Products]] || - || done. || {*} {*} {o}
|-
|-
| [[MusicBrainz]] Tagger || [http://musicbrainz.org/tagger/index.html http://musicbrainz.org/tagger/index.html] || [[MusicBrainz Tagger|MusicBrainzTagger]] || - || done. || {*} {*} {*}
| Classic Tagger || [http://musicbrainz.org/doc/ClassicTagger http://musicbrainz.org/doc/ClassicTagger] || [[Classic Tagger|ClassicTagger]] || - || done. || {*} {*} {*}
|-
|-
| Picard Tagger || [http://musicbrainz.org/doc/PicardTagger http://musicbrainz.org/doc/PicardTagger] || [[Picard Tagger|PicardTagger]] || - || done. || {*} {*} {*}
| ... more to add (the following is not complete nor ordered anymore)
|-
|-
| Magic Tagger || [http://musicbrainz.org/doc/MagicTagger http://musicbrainz.org/doc/MagicTagger] || [[Magic Tagger|MagicTagger]] || - || done. || {*} {*} {*}
| '''Contribute'''
|-
| Jaikoz MP3 Tag Editor || [http://musicbrainz.org/doc/JaikozMP3TagEditor http://musicbrainz.org/doc/JaikozMP3TagEditor] || [[Jaikoz MP3 Tag Editor|JaikozMP3TagEditor]] || - || done. ||
|-
| libmusicbrainz || [http://musicbrainz.org/doc/libmusicbrainz http://musicbrainz.org/doc/libmusicbrainz] || [[libmusicbrainz]] || - || done. ||
|-
| libtunepimp || [http://musicbrainz.org/doc/libtunepimp http://musicbrainz.org/doc/libtunepimp] || [[libtunepimp]] || - || done. ||
|-
| Server || [http://musicbrainz.org/doc/Server http://musicbrainz.org/doc/Server] || [[Server]] || - || done. ||
|-
| Database || [http://musicbrainz.org/doc/Database http://musicbrainz.org/doc/Database] || [[Database]] || - || done. ||
|-
| [[Live Data Feed|LiveDataFeed]] || [http://musicbrainz.org/doc/LiveDataFeed http://musicbrainz.org/doc/LiveDataFeed] || [[Live Data Feed|LiveDataFeed]] || - || done. ||
|-
| MusicBrainz Enabled Applications || [http://musicbrainz.org/doc/MusicBrainzEnabledApplications http://musicbrainz.org/doc/MusicBrainzEnabledApplications] || [[MusicBrainz Enabled Applications|MusicBrainzEnabledApplications]] || create new page, copy content, intertwingle || done, unless I'm wrong -- [[User:murdos|murdos]] || {*} {*} {o}
|-
| [[Web Service|WebService]] || [http://musicbrainz.org/doc/WebService http://musicbrainz.org/doc/WebService] || [[Web Service|WebService]] || - || done. ||
|-
| '''Search:''' not wikifiable
|-
| '''Edit:''' TODO
|-
| '''Account:''' not wikifiable
|-
| '''Contribute:''' TODO
|-
| '''Help:''' TODO
|-
| ... more to add (the following is not complete nor ordered anymore)
|-
|-
| How to Contribute || [http://musicbrainz.org/wd/Contribute http://musicbrainz.org/wd/Contribute] || [[How To Contribute|HowToContribute]] || Pages are roughly equal || review page || {*} {*} {o}
| How to Contribute || [http://musicbrainz.org/wd/Contribute http://musicbrainz.org/wd/Contribute] || [[How To Contribute|HowToContribute]] || Pages are roughly equal || review page || {*} {*} {o}
Line 75: Line 103:
| Development || [http://musicbrainz.org/development/index.html http://musicbrainz.org/development/index.html] || [[MusicBrainz Development|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 || {*} {*} {*}
| Development || [http://musicbrainz.org/development/index.html http://musicbrainz.org/development/index.html] || [[MusicBrainz Development|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://musicbrainz.org/mod_intro.html http://musicbrainz.org/mod_intro.html] || [[How Editing Works|HowEditingWorks]] || Clone of the old page, needs to be massively enhanced || enhance || {*} {*} {*}
| About Editing || [http://musicbrainz.org/mod_intro.html http://musicbrainz.org/mod_intro.html] || [[How Editing Works|HowEditingWorks]] || Clone of the old page, needs to be massively enhanced || enhance || {*} {*} {*}
|}
|}



Revision as of 11:57, 17 April 2007

WikiDocs Pages

Purpose

This page lists all wiki pages that should be part of the initial WikiDocs launch and listed in the WikiDocsTransclusionTable. This page NeedsUpdating.

General Issues

To decide which pages nedd to be added to the transclusion table 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 WikiDocsTransclusionTable 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 are somewhat harder to rename, 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 which will be made into WikiDocs Pages

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 {*} {*} {*}
Mirrors http://musicbrainz.org/doc/MirrorServer MirrorServer - done. {*} {o} {o}
People http://musicbrainz.org/doc/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}
Privacy http://musicbrainz.org/privacy which redirects to http://musicbrainz.org/docs/20050213-1.html EditorPrivacy 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. Well, WikiDocs provides a point-in-time freeze, which is as good as any static page (even better, since it allows to update the content without having to mess with server code. therefore i've ported the content to MusicBrainzPrivacyPolicy done (is it?). What do we do with EditorPrivacy? {o} {o} {o}
History http://musicbrainz.org/doc/MusicBrainzHistory MusicBrainzHistory done. {*} {*} {o}
Licenses http://musicbrainz.org/doc/MusicBrainzLicense MusicBrainzLicense create page, intertwingle done. {o} {o} {o}
Social Contract http://musicbrainz.org/doc/SocialContract SocialContract create page, intertwingle done. {o} {o} {o}
Statistics http://musicbrainz.org/doc/ServerStatistics ServerStatistics - Looks done. -- dmppanda 11:57, 17 April 2007 (UTC) {*} {o} {o}
Logos http://musicbrainz.org/doc/MusicBrainzLogo MusicBrainzLogo not really important, IMO done. {o} {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/doc/MusicBrainzPress MusicBrainzPress Should be updated by the community used existing page. done. {*} {o} {o}
Products
Products http://musicbrainz.org/doc/Products Products - done. {*} {*} {o}
Classic Tagger http://musicbrainz.org/doc/ClassicTagger ClassicTagger - done. {*} {*} {*}
Picard Tagger http://musicbrainz.org/doc/PicardTagger PicardTagger - done. {*} {*} {*}
Magic Tagger http://musicbrainz.org/doc/MagicTagger MagicTagger - done. {*} {*} {*}
Jaikoz MP3 Tag Editor http://musicbrainz.org/doc/JaikozMP3TagEditor JaikozMP3TagEditor - done.
libmusicbrainz http://musicbrainz.org/doc/libmusicbrainz libmusicbrainz - done.
libtunepimp http://musicbrainz.org/doc/libtunepimp libtunepimp - done.
Server http://musicbrainz.org/doc/Server Server - done.
Database http://musicbrainz.org/doc/Database Database - done.
LiveDataFeed http://musicbrainz.org/doc/LiveDataFeed LiveDataFeed - done.
MusicBrainz Enabled Applications http://musicbrainz.org/doc/MusicBrainzEnabledApplications MusicBrainzEnabledApplications create new page, copy content, intertwingle done, unless I'm wrong -- murdos {*} {*} {o}
WebService http://musicbrainz.org/doc/WebService WebService - done.
Search: not wikifiable
Edit: TODO
Account: not wikifiable
Contribute: TODO
Help: TODO
... more to add (the following is not complete nor ordered anymore)
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 {*} {*} {*}
About Editing http://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