WikiDocs Page

WikiDocs Pages

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

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 WikiTransclusion table 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	{*} {*} {*}
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. What do we do with EditorPrivacy?	{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	create new page, copy content, intertwingle	done, unless I'm wrong -- murdos	{*} {*} {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	MusicBrainzPress	Should be updated by the community	used existing page. done.	{*} {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://musicbrainz.org/mod_intro.html	HowEditingWorks	Clone of the old page, needs to be massively enhanced	enhance	{*} {*} {*}

... More to add

• FrequentlyAskedQuestions or http://musicbrainz.org/wd/FAQIndex done, by WolfSong
  • All pages of done, by WolfSong

• MusicBrainzForums or http://musicbrainz.org/wd/ContactUs i.e. Where can I reach you, where can I get help
  • MusicBrainzWiki i.e a page that describes the function of the wiki.
  • EditNote
  • MailingList and http://musicbrainz.org/list.html
  • A page about the Blog/News system (I don't think there is one, yet)
  • SourceForge i.e. a page about our source forge page (what we use it for and what not).
  • IRC (this should be renamed MusicBrainzChat or something like this, since it does not deal with IRC in general, but with our IRC)

• MusicBrainz or http://musicbrainz.org/wd/AboutMusicBrainz
  • EditorPrivacy or MusicBrainzPrivacyPolicy (http://musicbrainz.org/privacy) i think these pages can be kept separated. the talk about two different aspects of privacy in the MB universe. --Keschte
  • People: http://musicbrainz.org/bio.html or Category Person (hmm, how do you do that?)
  • A page that summarizes http://musicbrainz.org/about/licenses.html and http://musicbrainz.org/contract.html and perhaps http://musicbrainz.org/about/logos.html and the very good blog entry by Robert

• StyleGuideline and http://musicbrainz.org/style.html
  • OfficialStyleGuideline and all pages of Category Official Style
  • ProposedStyleGuideline but not the pages for the proposed guidelines themselves. These should remain in the wiki
  • CapitalizationStandard and its language specific sub-pages.
  • ClassicalStyleGuide

• EditingGuideline or http://musicbrainz.org/mod_intro.html (but avoiding BadTerminology) and content from the old InformationOnEditing.
  • http://musicbrainz.org/wd/ModerationFAQ (avoinding BadTerminology)

• MusicBrainzDocumentation

• 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