Difference between revisions of "WikiDocs Page"

From MusicBrainz Wiki
Jump to navigationJump to search
m (Removed second H1.)
(Ancient History: This page was created to help the transition to WikiDocs.)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
#REDIRECT [[WikiDocs]]
==Purpose==

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==

To decide which pages need 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 [[Wiki Docs Transclusion Table|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. [[Moin Moin|MoinMoin]] has an [http://moinmoin.wikiwikiweb.de/AntiSpamGlobalSolution 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 [[Good WikiName|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:
<ul><li style="list-style-type:none"><pre>## DontRenameWikiDocsPages! #acl -All:delete Default</pre>
</ul>A member of the [[Admin Group|AdminGroup]] will have to add this for you.

==Pages which will be made into WikiDocs Pages==

See also [[MusicBrainz Documentation|MusicBrainzDocumentation]] and even more importantly [[Restructuring The Documentation|RestructuringTheDocumentation]] for some prior work on this (especially proposed [[Wiki Name|WikiName]]s). This table follows the structure of the new top menu bar:
{| border="1"
|-
| '''Position in [[Site Menu|SiteMenu]]''' || '''Current URL''' || '''Corresponding [[Wiki Page|WikiPage]]''' || '''Notes''' || '''TODO''' || '''Priority'''
|-
| '''About'''
|-
| 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}
|-
| 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}
|-
| History || [http://musicbrainz.org/doc/MusicBrainzHistory http://musicbrainz.org/doc/MusicBrainzHistory] || [[MusicBrainz History|MusicBrainzHistory]] || || done. || {*} {*} {o}
|-
| Licenses || [http://musicbrainz.org/doc/MusicBrainzLicense http://musicbrainz.org/doc/MusicBrainzLicense] || [[MusicBrainz License|MusicBrainzLicense]] || create page, intertwingle || done. || {o} {o} {o}
|-
| Social Contract || [http://musicbrainz.org/doc/SocialContract http://musicbrainz.org/doc/SocialContract] || [[Social Contract|SocialContract]] || create page, intertwingle || done. || {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}
|-
| Logos || [http://musicbrainz.org/doc/MusicBrainzLogo http://musicbrainz.org/doc/MusicBrainzLogo] || [[MusicBrainz Logo|MusicBrainzLogo]] || not really important, IMO || done. || {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}
|-
| '''News'''
|-
| General News || [http://musicbrainz.org/news/index.html 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 http://musicbrainz.org/news/server.html] || none || Unwikifiable pages || || {o} {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}
|-
| '''Products'''
|-
| Products || [http://musicbrainz.org/doc/Products http://musicbrainz.org/doc/Products] || [[Products]] || - || done. || {*} {*} {o}
|-
| 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. || {*} {*} {*}
|-
| Magic Tagger || [http://musicbrainz.org/doc/MagicTagger http://musicbrainz.org/doc/MagicTagger] || [[Magic Tagger|MagicTagger]] || - || done. || {*} {*} {*}
|-
| 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}
|-
| 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 || {*} {*} {*}
|-
| 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 || {*} {*} {*}
|}

... More to add
* [[Frequently Asked Questions|FrequentlyAskedQuestions]] or [http://musicbrainz.org/wd/FAQIndex http://musicbrainz.org/wd/FAQIndex] [[Image:Checkmark.png]] done, by [[User:WolfSong|WolfSong]]
** All pages of[[Image:Checkmark.png]] done, by [[User:WolfSong|WolfSong]]

* [[MusicBrainz Forum|MusicBrainzForum]]s or [http://musicbrainz.org/wd/ContactUs http://musicbrainz.org/wd/ContactUs] i.e. Where can I reach you, where can I get help
** [[MusicBrainz Wiki|MusicBrainzWiki]] i.e a page that ''describes'' the function of the wiki.
** [[Edit Note|EditNote]]
** [[Mailing List|MailingList]] and [http://musicbrainz.org/list.html 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 [[MusicBrainz Chat|MusicBrainzChat]] or something like this, since it does not deal with IRC in general, but with ''our'' IRC)
*** The fact it is "[[MusicBrainz Chat|MusicBrainzChat]]" is obvious IMHO. The same goes for a number of other things in this wiki, which are dealing with the [[MusicBrainz]] aspect of things, not with a general definition of what they are. IMO such names shouldn't be bloated by [[MusicBrainz]] prefixes, as this add no value and make things more difficult to find (at least for the documentation pertaining to stuff we don't plan to detail in their "global" meaning). -- [[User:dmppanda|dmppanda]] 13:45, 27 April 2007 (UTC)

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

* [[Style Guideline|StyleGuideline]] and [http://musicbrainz.org/style.html http://musicbrainz.org/style.html]
** [[Official Style Guideline|OfficialStyleGuideline]] and all pages of Category Official Style
** [[Proposed Style Guideline|ProposedStyleGuideline]] but ''not'' the pages for the proposed guidelines themselves. These should remain in the wiki
** [[Capitalization Standard|CapitalizationStandard]] and its language specific sub-pages.
** [[Classical Style Guide|ClassicalStyleGuide]]

* [[Editing Guideline|EditingGuideline]] or [http://musicbrainz.org/mod_intro.html http://musicbrainz.org/mod_intro.html] (but avoiding [[Bad Terminology|BadTerminology]]) and content from the old [[Information On Editing|InformationOnEditing]].
** [http://musicbrainz.org/wd/ModerationFAQ http://musicbrainz.org/wd/ModerationFAQ] (avoinding [[Bad Terminology|BadTerminology]])

* [[MusicBrainz Documentation|MusicBrainzDocumentation]]

<ul><li style="list-style-type:none">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 [[Moderated Revision Table|ModeratedRevisionTable]] --[[User:DonRedman|DonRedman]]
* [[Advanced Relationships|AdvancedRelationships]] (once this has stabilzed and ''only if'' we have troubles with vandals all the subpages)
* [[Edit Type|EditType]] (but IMO not the edit type pages themeselves)
* ...

* [[MusicBrainz Terminology|MusicBrainzTerminology]]
** probably all pages of Category Terminology

</ul>

[[Category:To Be Reviewed]] [[Category:FAQ]] [[Category:Development]] [[Category:WikiDosc Page]]

Latest revision as of 21:02, 9 November 2009

Redirect to: