History:Wiki Wardening: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
((Imported from MoinMoin))
m (Reosarevok moved page Wiki Wardening to History:Wiki Wardening)
 
(22 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<small>WikiWardening > WikiWardening | [[Wiki Warden|WikiWarden]]<code><nowiki></nowiki></code>s </small>
<small>WikiWardening > WikiWardening | [[Wiki Warden|WikiWarden]]s </small>
{| border="1"
{| border="1"
|-
|-
Line 7: Line 7:
==Purpose==
==Purpose==


Early 2007, new attempt is made to push the wiki forward and drastically enhance both the documentation quality and the wiki health state as a whole. This page serves as a fast moving memo for [[Wiki Warden|WikiWarden]]<code><nowiki></nowiki></code>s to coordinate their work. It has no special structure, no rules, will be heavily edited, and most discussion started here will certainly be [[Delete When Cooked|DeleteWhenCooked]]. Still, ideas and discussion that are worth keeping may be moved to another page if there is a need for that (like [[Wiki Wardening History|WikiWardeningHistory]]). We should try our best to keep this document to a reasonable size and try restructure it from time to time (note it's already quite big and indigest, so hang on!).
Early 2007, a new attempt is made to push the wiki forward and drastically enhance both the documentation quality and the wiki health state as a whole. This page serves as a fast moving memo for [[Wiki Warden|WikiWarden]]s to coordinate their work. It has no special structure, no rules, will be heavily edited, and most discussion started here will certainly be [[Delete When Cooked|DeleteWhenCooked]]. Still, ideas and discussion that are worth keeping may be moved to another page if there is a need for that (like [[Wiki Wardening History|WikiWardeningHistory]]). We should try our best to keep this document to a reasonable size and try restructure it from time to time (note it's already quite big and indigest, so hang on!).


If you see anything in the documentation or in the wiki that should be addressed, report it here, or contact a [[Wiki Warden|WikiWarden]].
If you see anything in the documentation or in the wiki that should be addressed, report it here, or contact a [[Wiki Warden|WikiWarden]].


==Tickets watching==
==Obtain MoinMoin upgrade==


Short term objectives:
===Problem===
* [[Ticket:2320|2320]]: Upgrade [[Moin Moin|MoinMoin]] ([[Image:Attention.png]] pending resolution: see [[Updating To MoinMoin 1.5|UpdatingToMoinMoin1.5]] [[Image:Attention.png]])
* [[Ticket:2672|2672]]: Cards and transclusion behavior
* [[Ticket:1962|1962]]: Transclusion hasn't worked so well so far, lack of manpower
* [[Ticket:2705|2705]]: wiki.mb.org: Need new interwiki link for [[MusicBrainz]] codes sources
* [[Ticket:2625|2625]]: wiki.mb.org: Need new interwiki links for other Wikipedia (fr, de, ...)


Transclusion improvements:
We are stuck with an old [[Moin Moin|MoinMoin]] full of [[Link That Never Ends|deranging bugs]] and badly outdated.
* [[Ticket:1489|1489]]: Wiki transclusion data in wrong place
* [[Ticket:1112|1112]]: Wiki Transclusion should check for correct [[Wiki Name|WikiName]] and Revision Number
* also read some of the comments @ [[Ticket:1962|1962]]:


Low priority and questionable enhancements:
===Objective===
* [[Ticket:1799|1799]]: [[WikiDocs]] does not produce valid XHTML

* [[Ticket:1530|1530]]: Show transcluded wiki page in user profile in main site.
Collect enough choco to bribe [[User:Ruaok|Ruaok]] so he updates [[Moin Moin|MoinMoin]] to 1.5.x. but stop spamming him about this. :p The relevant ticket is [[Ticket:2320|2320]].

Note that the syntax and behavior of Cards will change with the update to 1.5.

===WikiWardens on this===


Long term objectives:
All! (note that Europeans have the best choco)
* [[Ticket:849|849]]: Provide translations for key documentation


==WantedPages==
==WantedPages==
Line 31: Line 36:
===Problem===
===Problem===


In its current state, [[Wanted Pages|WantedPages]] is unusable. Counts around 877.
In its current state, [[Special:WantedPages|WantedPages]] is unusable. When this effort started, we were above 1100 links. Now below 850.


===Objective===
===Objective===


Further bring it down (possibly ~500/600 links) by fixing bogus and misspelled links. Once it's there, keep it under surveillance. Note that creating documentation for ''valid'' [[Special:WantedPages|WantedPages]] is not a [[Wiki Warden|WikiWarden]] task: everybody can and should do that.
Bring it down below ~500 links.


===Recommendations===
===Recommendations===
Line 46: Line 51:
* Jazz/Label/* created quite a lot of bogus links, as they often contain records catalogs, with camelcased names. These pages will eventually disappear. Meanwhile, you can inhibit the links
* Jazz/Label/* created quite a lot of bogus links, as they often contain records catalogs, with camelcased names. These pages will eventually disappear. Meanwhile, you can inhibit the links


[[Image:Attention.png]] Just don't "inhibate" anything you see there! Specially:
[[Image:Attention.png]] Just don't "inhibit" anything you see! Specially:
* don't inhibate sigs for wiki editors without personal pages (they might want to create one later)!
* don't inhibit sigs for wiki editors without personal pages (they might want to create one later)!
* ''Never'' create empty pages. A wanted page is much better than a contentless stub.
* ''Never'' create empty pages. A wanted page is much better than a contentless stub.
* think twice before inhibiting things that looks like [[Bad WikiName|BadWikiName]] of otherwise valid [[Wanted Pages|WantedPages]].
* think twice before inhibiting things that looks like [[Bad WikiName|BadWikiName]] of otherwise valid [[Wanted Pages|WantedPages]].
Line 54: Line 59:
===Tips===
===Tips===


* to inhibate a camelcased link, use <code><nowiki>!BogusLink</nowiki></code>.
* <s>to inhibit a camelcased link, use <code><nowiki>!BogusLink</nowiki></code>. </s> not relevant; MediaWiki doesn't use CamelCase links
* to inhibate a bracketted link, use entities instead of brackets: <code><nowiki>&#91;"Bogus Link"&#93;</nowiki></code>
* to inhibit a bracketed link, use entities instead of brackets: <code><nowiki>&#91;"Bogus Link"&#93;</nowiki></code>, or just use nowiki tags: <nowiki>&lt;nowiki>[[Bogus Link]]&lt;/nowiki></nowiki>


A short [[WikiZen]] lecture ;-) on [[Wanted Pages|WantedPages]]: Sometimes a wanted page serves a purpose: It carries the information that there is ''something'' that people refer to, but nobody has taken the time to explain what it is, yet. It also helps to create the intertwingled links for a page that does not exist, yet. Tihs way once the page is created, it is already well intertwingled. In rare cases a wanted page can even give a very realistic notion of a 'blank', or taboo, or untold story. IIRC [[MeatBall:SunirResigns|SunirResigns]] on MeatBall was a very interesting example of this (I don't know if any trace remains of it).
A short [[WikiZen]] lecture ;-) on [[Special:WantedPages|WantedPages]]: Sometimes a wanted page serves a purpose: It carries the information that there is ''something'' that people refer to, but nobody has taken the time to explain what it is, yet. It also helps to create the intertwingled links for a page that does not exist, yet. This way once the page is created, it is already well intertwingled. In rare cases a wanted page can even give a very realistic notion of a 'blank', or taboo, or untold story. IIRC [[MeatBall:SunirResigns|SunirResigns]] on MeatBall was a very interesting example of this (I don't know if any trace remains of it).


===WikiWardens on this===
===WikiWardens on this===
Line 69: Line 74:
===Problem===
===Problem===


Pages are created by everybody, from [[Wiki Master|WikiMaster]]<code><nowiki></nowiki></code>s to [[Wiki Newbie|WikiNewbie]]<code><nowiki></nowiki></code>s. The later usually don't use categories, don't sign their edits, don't intertwingle things, use [[Bad WikiName|BadWikiName]]<code><nowiki></nowiki></code>s, don't check spelling, introduce bogus links, or even create completely useless pages.
Pages are created by everybody, from [[Wiki Master|WikiMaster]]s to [[Wiki Newbie|WikiNewbie]]s. The later usually don't use categories, don't sign their edits, don't intertwingle things, use [[Bad WikiName|BadWikiName]]s, don't check spelling, introduce bogus links, or even create completely useless pages.


===Objective===
===Objective===


Monitor all page creation: immediately check the spelling, and at least mark these pages with the relevant [[Wiki Tag|WikiTag]]<code><nowiki></nowiki></code>s:
Monitor all page creation: immediately check the spelling, and at least mark these pages with the relevant [[Wiki Tag|WikiTag]]s:
* [[Needs Editing|NeedsEditing]]
* [[Needs Editing|NeedsEditing]]
* [[Needs Intertwingling|NeedsIntertwingling]]
* [[Needs Intertwingling|NeedsIntertwingling]]
Line 81: Line 86:
* [[Candidate For Deletion|CandidateForDeletion]]
* [[Candidate For Deletion|CandidateForDeletion]]
* [[Deleted Page|DeletedPage]]
* [[Deleted Page|DeletedPage]]
* [[Stub]]
* <nowiki>{{Stub}}</nowiki>


===Recommendations===
Maybe we should have also:

* [[Needs Categorizing|NeedsCategorizing]] I sometimes ends up adding the whole set of "Needs*" [[Wiki Tag|WikiTag]]<code><nowiki></nowiki></code>s to a page that needs all/most... Maybe we should have something like [[Needs All|NeedsAll]]? Or NeedsALot? Or [[Needs Love|NeedsLove]]? -- [[User:dmppanda|dmppanda]] 04:40, 07 April 2007 (UTC)
A Wiki lives because it's growing. Be kind to [[Wiki Newbie|WikiNewbie]]s and don't discourage vocations by being a [[Wiki Bitch|WikiBitch]]. Help new users and enhance existing content integration and formal quality, but don't pass judgment on content or clumsiness of the editors. Remember you're a [[Wiki Warden|WikiWarden]]: above all, do no harm.


===WikiWardens on this===
===WikiWardens on this===
Line 90: Line 96:
* [[User:dmppanda|dmppanda]]
* [[User:dmppanda|dmppanda]]
* [[User:murdos|murdos]]
* [[User:murdos|murdos]]




==DeletedPage==
==DeletedPage==
Line 110: Line 118:
* Please don't delete personal pages, even empty, even abandoned for years, even orphaned (though you may eventually edit them to at least be of CategoryPerson). They serve as a witness of people who contributed to MusicBrainz in the early days. It is ok that the wiki evolves without them, but it's not ok to erase these people from our history. Maybe a short sentence like "XY was a contributor to this wiki in its prehistoric times (i.e. before migration to [[Moin Moin|MoinMoin]])" is better than a completely empty page.
* Please don't delete personal pages, even empty, even abandoned for years, even orphaned (though you may eventually edit them to at least be of CategoryPerson). They serve as a witness of people who contributed to MusicBrainz in the early days. It is ok that the wiki evolves without them, but it's not ok to erase these people from our history. Maybe a short sentence like "XY was a contributor to this wiki in its prehistoric times (i.e. before migration to [[Moin Moin|MoinMoin]])" is better than a completely empty page.


You may want to take a look at [[Abandoned Pages|AbandonedPages]] and [[Orphaned Pages|OrphanedPages]] (and also to [[Stub]]) to find [[Candidate For Deletion|CandidateForDeletion]]. Also, you may want to review pages that don't directly pertain to [[MusicBrainz]] (pages on foreign technologies/random topics for example). Most of them should be superseded by their equivalent (better and maintained) pages at [[Wikipedia|WikiPedia]].
You may want to take a look at [[Abandoned Pages|AbandonedPages]] and [[Special:LonelyPages|OrphanedPages]] (and also to [[:Category:Stubs]]) to find [[Candidate For Deletion|CandidateForDeletion]]. Also, you may want to review pages that don't directly pertain to [[MusicBrainz]] (pages on foreign technologies/random topics for example). Most of them should be superseded by their equivalent (better and maintained) pages at [[Wikipedia|WikiPedia]].


Tips regarding page deletion:
Tips for [[Wiki Warden|WikiWarden]]<code><nowiki></nowiki></code>s not member of the [[Page Deletor Group|PageDeletorGroup]]:
* if you're sure a page should be deleted, add a [[Deleted Page|DeletedPage]] tag somewhere in it, with some arguments
* if you're sure a page should be deleted, add a [[Deleted Page|DeletedPage]] tag somewhere in it, with some arguments
* if you think, but are not sure a page should be deleted, use [[Candidate For Deletion|CandidateForDeletion]] instead
* if you think, but are not sure a page should be deleted, use [[Candidate For Deletion|CandidateForDeletion]] instead
* subscribe to this page, so you are notified of changes on it and can answer people
* subscribe to this page, so you are notified of changes on it and can answer people
* wait a month. If no one reacts negatively, either change the tag from [[Candidate For Deletion|CandidateForDeletion]] to [[Deleted Page|DeletedPage]] and wait a bit more, or if it is already a [[Deleted Page|DeletedPage]], bug somebody in [[Page Deletor Group|PageDeletorGroup]] so that he deletes the page effectively
* wait a month. If no one reacts negatively, either change the tag from [[Candidate For Deletion|CandidateForDeletion]] to [[Deleted Page|DeletedPage]] and wait a bit more, or if it is already a [[Deleted Page|DeletedPage]], bug a wiki administrator ([http://wiki.musicbrainz.org/Special:Listusers%26group%3Dwiki-editor listed here]) so that they can delete the page effectively


If you are a wiki administrator and are deleting a page, please:
Tips for members of [[Page Deletor Group|PageDeletorGroup]]:
* do a full text search on the wiki to list all links pointing to the [[Deleted Page|DeletedPage]]: something like <code><nowiki>[[FullSearch(linkto:DumbPage)]]</nowiki></code>
* do a full text search on the wiki to list all links pointing to the [[Deleted Page|DeletedPage]]: something like <code><nowiki>[[FullSearch(linkto:DumbPage)]]</nowiki></code>
* replace all links by their proper replacement: if there is no legit replacement, then this page probably shouldn't be deleted!
* replace or inhibate all links
* [[Dont Delete Wiki Docs Pages|DontDeleteWikiDocsPages]]! You '''must not''' do it, it would break [[WikiDocs]]. Luckily you can't, since [[WikiDocs Page|WikiDocsPage]]<code><nowiki></nowiki></code>s are delete protected. If you are in doubt check if the page is in the [[Wiki Docs Transclusion Table|WikiDocsTransclusionTable]]. To deal with a [[WikiDocs]] page listed in [[Deleted Page|DeletedPage]] you'll have extra work to do (and you'll need a [[Transclusion Editor|TransclusionEditor]] and a member of the [[Admin Group|AdminGroup]])
* [[Dont Delete Wiki Docs Pages|DontDeleteWikiDocsPages]]! You '''must not''' do it, it would break [[WikiDocs]]. Luckily you can't, since [[WikiDocs Page|WikiDocsPage]]s are delete protected. If you are in doubt check if the page is in the [[Wiki Docs Transclusion Table|WikiDocsTransclusionTable]]. To deal with a [[WikiDocs]] page listed in [[Deleted Page|DeletedPage]] you'll have extra work to do (and you'll need a [[Transclusion Editor|TransclusionEditor]] and a member of the [[Admin Group|AdminGroup]])
* triple check that you're doing the right thing
* triple check that you're doing the right thing
* delete the page
* delete the page
Line 130: Line 138:


You do not expect me to give you an ok for each and every page, do you? MB has enough bureaucracy already. I have commented on some, where I disagree. I believe there are some more that could be left if you look at them from a different, gentler angle. --[[User:DonRedman|DonRedman]]
You do not expect me to give you an ok for each and every page, do you? MB has enough bureaucracy already. I have commented on some, where I disagree. I believe there are some more that could be left if you look at them from a different, gentler angle. --[[User:DonRedman|DonRedman]]
<ul><li style="list-style-type:none">hé :-) I believe this is why [[Deleted Page|DeletedPage]] is a good process. This leave time to take a second (or third) (gentler) look at things and change mind. -- [[User:dmppanda|dmppanda]] 19:35, 06 April 2007 (UTC)
:hé :-) I believe this is why [[Deleted Page|DeletedPage]] is a good process. This leave time to take a second (or third) (gentler) look at things and change mind. -- [[User:dmppanda|dmppanda]] 19:35, 06 April 2007 (UTC)
</ul>


===WikiWardens on this===
===WikiWardens on this===
Line 139: Line 146:
* [[User:DonRedman|DonRedman]]
* [[User:DonRedman|DonRedman]]


==Pages that should point to wikipedia instead==
==Pages that should point to Wikipedia instead==


See [[Deleted Page|DeletedPage]] above. Maybe maintain a list of these here.
See [[Deleted Page|DeletedPage]] above. Maybe maintain a list of these here.
Line 161: Line 168:
==WikiNewbies==
==WikiNewbies==


Create a page for [[Wiki Newbie|WikiNewbie]]<code><nowiki></nowiki></code>s with good practice guidelines on this wiki. This may be [[Good Wiki Style|GoodWikiStyle]], but it needs enhancement.
Create a page for [[Wiki Newbie|WikiNewbie]]s with good practice guidelines on this wiki. This may be [[Good Wiki Style|GoodWikiStyle]], but it needs enhancement.


With a (short) checklist of things to verify (intertwingling, categories, spelling, etc).
With a (short) checklist of things to verify (intertwingling, categories, spelling, etc).


==WikiCategories==
==WikiCategorization==


'''Objective:''' Establish a usable [[Wiki Categorization|WikiCategorization]]
'''Objective:''' Establish [[Wiki Categories|WikiCategories]] to be used everywhere in the wiki

* [[Wiki Tag|WikiTag]]<code><nowiki></nowiki></code>s
Please see and comment [[Talk:Wiki Categories|WikiCategoriesDiscussion]]
<ul><li style="list-style-type:none">Done, but currently all pages fromare excluded from searches
</ul>
* Split* Maybe split* Read/rewrite/enhance categories descriptions
* Check what's in [[Talk:Categories|CategoriesDiscussion]]


===WikiWardens on this===
===WikiWardens on this===


* [[User:murdos|murdos]]
* [[User:murdos|murdos]]

==Update WikiDocs related docs==

Attachments, includes, cards, etc. Also see [[Moin Moin|MoinMoin]] 1.5 migration.


==Historical pages==
==Historical pages==


<small>'''Depends on [[Wiki Categorization|WikiCategorization]]'''</small>
<small>'''Depends on [[Wiki Categories|WikiCategories]]'''</small>


Create an entry point like [[History Of MusicBrainz|HistoryOfMusicBrainz]] for historical pages. Create special categories for historical proposal, historical guidelines, ...
Create an entry point like [[History Of MusicBrainz|HistoryOfMusicBrainz]] for historical pages. Create special categories for historical proposal, historical guidelines, ...


'''Note:''' there's also a page with a similar name: [[MusicBrainz History|MusicBrainzHistory]] that we should maybe rename (but this is a WikiDocsPage)
'''Note:''' there's also a page with a similar name: [[MusicBrainz History|MusicBrainzHistory]] that we should maybe rename (but this is a WikiDocsPage)

===WikiWardens on this===

* [[User:murdos|murdos]]


==Promote transclusion==
==Promote transclusion==


I'm not sure [[WikiDocs]] and transclusion are directly related to WikiWardening: a [[Transclusion Editor|TransclusionEditor]] sure need to be a [[Wiki Warden|WikiWarden]] of his wikidocs pages, but a lot of wikipages don't need to be [[WikiDocs]]. Might be related to restructurating/documenting distinction. -- [[User:murdos|murdos]] 16:52, 05 April 2007 (UTC)
I'm not sure [[WikiDocs]] and transclusion are directly related to WikiWardening: a [[Transclusion Editor|TransclusionEditor]] sure need to be a [[Wiki Warden|WikiWarden]] of his wikidocs pages, but a lot of wikipages don't need to be [[WikiDocs]]. Might be related to restructurating/documenting distinction. -- [[User:murdos|murdos]] 16:52, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">Sure. And we definitely need to separate documentation efforts, and restructuration/wardening. Though, I think both belong here, because of a simple fact: we don't have arms enough to afford the separation... For now, all manpower is here I guess :-) -- [[User:dmppanda|dmppanda]] 19:33, 05 April 2007 (UTC)
:Sure. And we definitely need to separate documentation efforts, and restructuration/wardening. Though, I think both belong here, because of a simple fact: we don't have arms enough to afford the separation... For now, all manpower is here I guess :-) -- [[User:dmppanda|dmppanda]] 19:33, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">For reference, previous wiki improvement attempt has been split in [[Restructure The Wiki|RestructureTheWiki]] and [[Restructuring The Documentation|RestructuringTheDocumentation]]. -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
::For reference, previous wiki improvement attempt has been split in [[Restructure The Wiki|RestructureTheWiki]] and [[Restructuring The Documentation|RestructuringTheDocumentation]]. -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>
</ul>


Split documentation into responsibilities zones.
Split documentation into responsibilities zones.
* [[User:dmppanda|dmppanda]]:
* [[User:dmppanda|dmppanda]]:
**: clean, transcluded
** [[MBWiki:CategoryAnnotation|CategoryAnnotation]]: clean, transcluded
**: some work to do, transclusion ASAP
** [[MBWiki:CategoryLabel|CategoryLabel]]: some work to do, transclusion ASAP


Raw ideas:
Raw ideas:
Line 218: Line 212:


==Raw ideas and various things todo==
==Raw ideas and various things todo==

* More [[Wiki Tag|WikiTag]]<code><nowiki></nowiki></code>s:
** [[Prove Me Wrong|ProveMeWrong]]: some sort of [[Answer Me|AnswerMe]]. Use this when you think you are damn right :-), but it's a touchy or debatable topic, and you want a clean and firm approval of your idea, or simply if you want to wake-up/challenge people.
** [[Fix Me Before Transclusion|FixMeBeforeTransclusion]] (or [[Prevent Transclusion|PreventTransclusion]]?): self-explicit. Use this to remember to fix that little sentence lost somewhere in your [[Wiki Page|WikiPage]] that you don't want to see in your [[Wiki Doc|WikiDoc]].


* Promote the use of cards (don't forget that Cards on navigation don't really behave nicely)
* Promote the use of cards (don't forget that Cards on navigation don't really behave nicely)
<ul><li style="list-style-type:none">But don't overuse them ;-)
:But don't overuse them ;-)
</ul>
* Build templates for cards
* Build templates for cards
* niceify the documentation! Random ideas:
* niceify the documentation! Random ideas:
Line 241: Line 230:
* investigate the behavior of Cards with arguments, and how to use that for status card differentiation depending on the caller page in transcluded pages.
* investigate the behavior of Cards with arguments, and how to use that for status card differentiation depending on the caller page in transcluded pages.
* discuss if the current structure used on annotation is a good thing (or not) that we could reuse as a "template" for a number of other things (Artist, Release...):
* discuss if the current structure used on annotation is a good thing (or not) that we could reuse as a "template" for a number of other things (Artist, Release...):
** all pages have the category of the topic (eg:)
** all pages have the category of the topic (eg: [[MBWiki:CategoryAnnotation|CategoryAnnotation]])
** Navigation and intertwingling cards.
** Navigation and intertwingling cards.
** Pages declined following:
** Pages declined following:
Line 254: Line 243:
*** Additional documentation specific to the topic
*** Additional documentation specific to the topic


* [[Image:Attention.png]] have the damned [[Sortname|SortName]] and [[Sortname Style|SortNameStyle]] pages somehow renamed (needs to asset the risks before, [[WikiDocs]] status, if taggers use it, etc...)
* Add an historical notice, rename and/or reuse/update pages of previous wiki restructuring attempt: [[Big Mess|BigMess]], [[Status Of This Wiki|StatusOfThisWiki]], [[Restructuring The Documentation|RestructuringTheDocumentation]], [[Restructure The Wiki|RestructureTheWiki]]
* Add an historical notice, rename and/or reuse/update pages of previous wiki restructuring attempt: [[Big Mess|BigMess]], [[Status Of This Wiki|StatusOfThisWiki]], [[Restructuring The Documentation|RestructuringTheDocumentation]], [[Restructure The Wiki|RestructureTheWiki]]
* Use [[WikiDocs]] related pages for [[WikiDocs]] work
* Use [[WikiDocs]] related pages for [[WikiDocs]] work
* Think about translating documentation. This is a long term objective. Here's a partial copy of a private mail by [[User:DonRedman|DonRedman]], with some interesting thoughts:
* Think about translating documentation. This is a long term objective. Here's a partial copy of a private mail by [[User:DonRedman|DonRedman]], with some interesting thoughts:
*: I believe this does not make sense before MB has language sub-communities. MB is still too small for that. I would not start to translate documentation. This is an enormous, tedious, and never-ending task, and in the worst case nobody will use your work. So, if you *want* to start this, I'd suggest you build up a French sub-community first. With some nice welcome-pages and stuff. *Then* if there are a few people around (not under six active and over a dozen casual contributors, a few active French forum threads, and a feeling of "we") the french pages will probably start to grow all by their own. That is the moment to recognise. Then you push a lot of energy and enthusiasm into it.

*: [...]
<pre> "I believe this does not make sense before MB has language sub-communities. MB is still too small for that. I would not start to translate documentation. This is an enormous, tedious, and never-ending task, and in the worst case nobody will use your work. So, if you *want* to start this, I'd suggest you build up a French
sub-community first. With some nice welcome-pages and stuff. *Then* if there are a few people around (not under six active and over a dozen casual contributors, a few active French forum threads, and a feeling of "we") the french pages will probably start to grow all by their own. That is the moment to recognise. Then you push a lot of energy and enthusiasm into it. [...] French and German are best candidates for this, although French are less used to do everything in English (which is an advantage here)."
*: French and German are best candidates for this, although French are less used to do everything in English (which is an advantage here).
* Update [[WikiDocs]] related pages (attachments, includes, cards, etc. Also see [[Moin Moin|MoinMoin]] 1.5 migration) ([[User:dmppanda|dmppanda]]'s mess)
</pre>

==Bugs!!!==

[[Image:Attention.png]] Urgent TODO: triage this and report to [[User:Ruaok|Ruaok]] as he's willing to help us ''now''.
* [[Image:Attention.png]] [[Ticket:2320|2320]]: Upgrade [[Moin Moin|MoinMoin]]
* [[Image:Attention.png]] [[Ticket:2672|2672]]: Cards and transclusion behavior
* [[Ticket:1962|1962]]: Transclusion hasn't work so well so far, lack of manpower
<ul><li style="list-style-type:none">We need to prove that wrong! -- [[User:dmppanda|dmppanda]] 15:48, 05 April 2007 (UTC)
</ul>
* [[Ticket:1799|1799]]: [[WikiDocs]] does not produce valid XHTML
* [[Ticket:1530|1530]]: Show transcluded wiki page in user profile in main site.
<ul><li style="list-style-type:none">Not sure this is a so good idea. I for one don't want to see my big blurb/notes appear in my (very short) bio. -- [[User:dmppanda|dmppanda]] 15:48, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">I agree too. But you should definitely add your comment on the ticket, not here ;) -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>
</ul>
* [[Ticket:1489|1489]]: Wiki transclusion data in wrong place
* [[Ticket:1112|1112]]: Wiki Transclusion should check for correct [[Wiki Name|WikiName]] and Revision Number
* [[Ticket:849|849]]: Provide translations for key documentation


==Things here for some reason :-)==
==Things here for some reason :-)==
Line 293: Line 263:
* AR
* AR


===Links to pages that shouldn't appear in OrphanedPages...===

See [[Wiki Wardening/Wrongly Orphaned Pages|WikiWardening/WronglyOrphanedPages]]


[[Category:Candidate for Deletion]] [[Category:To Be Reviewed]] [[Category:Wiki]] [[Category:Terminology]] [[Category:To Do List]] [[Category:Annotation]] [[Category:Label]] [[Category:Development]] [[Category:Annotation]] [[Category:Discussion]] [[Category:To Do List]] [[Category:Wiki]]
[[Category:To Be Reviewed]] [[Category:Development]] [[Category:Discussion]] [[Category:To Do List]] [[Category:Wiki]]

Latest revision as of 16:07, 3 July 2013

WikiWardening > WikiWardening | WikiWardens

Content

Purpose

Early 2007, a new attempt is made to push the wiki forward and drastically enhance both the documentation quality and the wiki health state as a whole. This page serves as a fast moving memo for WikiWardens to coordinate their work. It has no special structure, no rules, will be heavily edited, and most discussion started here will certainly be DeleteWhenCooked. Still, ideas and discussion that are worth keeping may be moved to another page if there is a need for that (like WikiWardeningHistory). We should try our best to keep this document to a reasonable size and try restructure it from time to time (note it's already quite big and indigest, so hang on!).

If you see anything in the documentation or in the wiki that should be addressed, report it here, or contact a WikiWarden.

Tickets watching

Short term objectives:

  • 2320: Upgrade MoinMoin (Attention.png pending resolution: see UpdatingToMoinMoin1.5 Attention.png)
  • 2672: Cards and transclusion behavior
  • 1962: Transclusion hasn't worked so well so far, lack of manpower
  • 2705: wiki.mb.org: Need new interwiki link for MusicBrainz codes sources
  • 2625: wiki.mb.org: Need new interwiki links for other Wikipedia (fr, de, ...)

Transclusion improvements:

  • 1489: Wiki transclusion data in wrong place
  • 1112: Wiki Transclusion should check for correct WikiName and Revision Number
  • also read some of the comments @ 1962:

Low priority and questionable enhancements:

  • 1799: WikiDocs does not produce valid XHTML
  • 1530: Show transcluded wiki page in user profile in main site.

Long term objectives:

  • 849: Provide translations for key documentation

WantedPages

Problem

In its current state, WantedPages is unusable. When this effort started, we were above 1100 links. Now below 850.

Objective

Further bring it down (possibly ~500/600 links) by fixing bogus and misspelled links. Once it's there, keep it under surveillance. Note that creating documentation for valid WantedPages is not a WikiWarden task: everybody can and should do that.

Recommendations

  • A lot of links in there are "just bogus" (accidental CamelCase, wrong use of brackets ["ASIN"], etc). All of these should be "fixed" (edited so that they don't link anymore).
  • Some links in there are typo-ed, and should be properly edited to point to the correct page.
  • Some links are outdated (page has moved), they should be fixed also
  • broken sigs: some WikiZen have troubles spelling their own names :-) (Ruaok, among other) - help them for their own good!
  • missing redirect: some WikiZen have a personal page, but use a differently named wiki account. Create the redirection page for them.
  • Jazz/Label/* created quite a lot of bogus links, as they often contain records catalogs, with camelcased names. These pages will eventually disappear. Meanwhile, you can inhibit the links

Attention.png Just don't "inhibit" anything you see! Specially:

  • don't inhibit sigs for wiki editors without personal pages (they might want to create one later)!
  • Never create empty pages. A wanted page is much better than a contentless stub.
  • think twice before inhibiting things that looks like BadWikiName of otherwise valid WantedPages.
  • when in doubt, just leave them alone!

Tips

  • to inhibit a camelcased link, use !BogusLink. not relevant; MediaWiki doesn't use CamelCase links
  • to inhibit a bracketed link, use entities instead of brackets: ["Bogus Link"], or just use nowiki tags: <nowiki>[[Bogus Link]]</nowiki>

A short WikiZen lecture ;-) on WantedPages: Sometimes a wanted page serves a purpose: It carries the information that there is something that people refer to, but nobody has taken the time to explain what it is, yet. It also helps to create the intertwingled links for a page that does not exist, yet. This way once the page is created, it is already well intertwingled. In rare cases a wanted page can even give a very realistic notion of a 'blank', or taboo, or untold story. IIRC SunirResigns on MeatBall was a very interesting example of this (I don't know if any trace remains of it).

WikiWardens on this

  • dmppanda
  • murdos
  • slowly retreating, but still annoying everybody with his obscure sociological ideas: ;-) DonRedman

Monitor incoming pages

Problem

Pages are created by everybody, from WikiMasters to WikiNewbies. The later usually don't use categories, don't sign their edits, don't intertwingle things, use BadWikiNames, don't check spelling, introduce bogus links, or even create completely useless pages.

Objective

Monitor all page creation: immediately check the spelling, and at least mark these pages with the relevant WikiTags:

Recommendations

A Wiki lives because it's growing. Be kind to WikiNewbies and don't discourage vocations by being a WikiBitch. Help new users and enhance existing content integration and formal quality, but don't pass judgment on content or clumsiness of the editors. Remember you're a WikiWarden: above all, do no harm.

WikiWardens on this


DeletedPage

Problem

We have quite a lot of pages completely useless or irrelevant to MusicBrainz.

Objective

  • They should be removed, and if any, all the links to them replaced by proper links to other resources (eg: WikiPedia).
  • Update and simplify the informal "deletion mechanism" (that we inherited). Update the relevant documentation.

Recommendations

  • Please don't delete pages that present historical interest. These are handled differently. They need
    • A good status notice that puts the page into context. If you cannot provide this, ask some elders.
    • A category history
  • Please don't delete personal pages, even empty, even abandoned for years, even orphaned (though you may eventually edit them to at least be of CategoryPerson). They serve as a witness of people who contributed to MusicBrainz in the early days. It is ok that the wiki evolves without them, but it's not ok to erase these people from our history. Maybe a short sentence like "XY was a contributor to this wiki in its prehistoric times (i.e. before migration to MoinMoin)" is better than a completely empty page.

You may want to take a look at AbandonedPages and OrphanedPages (and also to Category:Stubs) to find CandidateForDeletion. Also, you may want to review pages that don't directly pertain to MusicBrainz (pages on foreign technologies/random topics for example). Most of them should be superseded by their equivalent (better and maintained) pages at WikiPedia.

Tips regarding page deletion:

  • if you're sure a page should be deleted, add a DeletedPage tag somewhere in it, with some arguments
  • if you think, but are not sure a page should be deleted, use CandidateForDeletion instead
  • subscribe to this page, so you are notified of changes on it and can answer people
  • wait a month. If no one reacts negatively, either change the tag from CandidateForDeletion to DeletedPage and wait a bit more, or if it is already a DeletedPage, bug a wiki administrator (listed here) so that they can delete the page effectively

If you are a wiki administrator and are deleting a page, please:

  • do a full text search on the wiki to list all links pointing to the DeletedPage: something like [[FullSearch(linkto:DumbPage)]]
  • replace all links by their proper replacement: if there is no legit replacement, then this page probably shouldn't be deleted!
  • DontDeleteWikiDocsPages! You must not do it, it would break WikiDocs. Luckily you can't, since WikiDocsPages are delete protected. If you are in doubt check if the page is in the WikiDocsTransclusionTable. To deal with a WikiDocs page listed in DeletedPage you'll have extra work to do (and you'll need a TransclusionEditor and a member of the AdminGroup)
  • triple check that you're doing the right thing
  • delete the page

Right now, there are a bunch of pages in DeletedPage. They wait for review from DonRedman and others, and they may be deleted at the end of April 2007. Please also monitor CandidateForDeletion.

Attention.png Important note: some/most/all of these pages are not ready to be deleted. Some of them still have a lot of links that point to them, some of them are even WikiDocs pages! They are there because we think they should be deleted - in a month, before doing so, and if no-one vetoes on their deletion, a preliminary work will have to be done prior to their actual deletion.

You do not expect me to give you an ok for each and every page, do you? MB has enough bureaucracy already. I have commented on some, where I disagree. I believe there are some more that could be left if you look at them from a different, gentler angle. --DonRedman

hé :-) I believe this is why DeletedPage is a good process. This leave time to take a second (or third) (gentler) look at things and change mind. -- dmppanda 19:35, 06 April 2007 (UTC)

WikiWardens on this

Pages that should point to Wikipedia instead

See DeletedPage above. Maybe maintain a list of these here.

Jazz

Problem

This is my mess. There are several problems with the Jazz/Label/* pages which include:

  • bogus camel links (see WantedPages)
  • pages appear orphaned

Objective

  • Migrate all relevant data into MusicBrainz (now that we have labels!).

Recommendations

Just ignore these pages whenever they appear (but in WantedPages)

WikiNewbies

Create a page for WikiNewbies with good practice guidelines on this wiki. This may be GoodWikiStyle, but it needs enhancement.

With a (short) checklist of things to verify (intertwingling, categories, spelling, etc).

WikiCategories

Objective: Establish WikiCategories to be used everywhere in the wiki

Please see and comment WikiCategoriesDiscussion

WikiWardens on this

Historical pages

Depends on WikiCategories

Create an entry point like HistoryOfMusicBrainz for historical pages. Create special categories for historical proposal, historical guidelines, ...

Note: there's also a page with a similar name: MusicBrainzHistory that we should maybe rename (but this is a WikiDocsPage)

Promote transclusion

I'm not sure WikiDocs and transclusion are directly related to WikiWardening: a TransclusionEditor sure need to be a WikiWarden of his wikidocs pages, but a lot of wikipages don't need to be WikiDocs. Might be related to restructurating/documenting distinction. -- murdos 16:52, 05 April 2007 (UTC)

Sure. And we definitely need to separate documentation efforts, and restructuration/wardening. Though, I think both belong here, because of a simple fact: we don't have arms enough to afford the separation... For now, all manpower is here I guess :-) -- dmppanda 19:33, 05 April 2007 (UTC)
For reference, previous wiki improvement attempt has been split in RestructureTheWiki and RestructuringTheDocumentation. -- murdos 00:07, 06 April 2007 (UTC)

Split documentation into responsibilities zones.

Raw ideas:

  • suggestion for a new transclusion interface on 1962
  • propose the use of "transclusion zones" and fine grained transclusion rights management

Open Questions

  • Category nesting (murdos).
  • think of a masterplan about categories.
  • *really* investigate transclusion behavior and hacks to be able to easily do full searches on transcluded documentation rather than on wiki content

Raw ideas and various things todo

  • Promote the use of cards (don't forget that Cards on navigation don't really behave nicely)
But don't overuse them ;-)
  • Build templates for cards
  • niceify the documentation! Random ideas:
    • use some specific style to make nav and intertwingling cards look a bit different (dirty hack: call the card from within a styled table)
    • use "smileys" to underline semantic value of things
    • use different icons in the head of pages, that "reflects" the part of the documentation we are in (eg: categories or "topic").
  • investigate Cards/Intertwingling ideas (think WikiPedia "portals")
  • differentiate restructuring tasks (defining categories, renaming, ...) and improving content tasks (updating docs, ...)
  • find some documentation about FullSearch macro (where the heck is it located?)
  • HelpOnSearching, or you want more? If think we should also document the different behavior between FullSearch(linkto:Page) and FullSearch(Page): the first works on generated content (after macro expanding), although the second seems to work on text source. Both have inconvenience... :| -- murdos 00:07, 06 April 2007 (UTC)
  • move my ass to have Label doc in a decent state
  • discuss if we want to addto ".+Future" pages, or if we want a new category.
  • investigate the behavior of Cards with arguments, and how to use that for status card differentiation depending on the caller page in transcluded pages.
  • discuss if the current structure used on annotation is a good thing (or not) that we could reuse as a "template" for a number of other things (Artist, Release...):
    • all pages have the category of the topic (eg: CategoryAnnotation)
    • Navigation and intertwingling cards.
    • Pages declined following:
      • Mainpage (eg: Annotation)
      • FAQ (eg: AnnotationFAQ, plus category FAQ)
      • Howto (eg: HowAnnotationsWork, plus category Howto)
      • History (eg: AnnotationHistory, plus category History)
      • Discussion (eg: AnnotationDiscussion, plus category Discussion)
      • Future (eg: AnnotationFuture, actually plus category Discussion, maybe Development or something else)
      • Edits doc
      • AdvancedRelationships documentation (not for Annotation obviously)
      • Additional documentation specific to the topic
  • Add an historical notice, rename and/or reuse/update pages of previous wiki restructuring attempt: BigMess, StatusOfThisWiki, RestructuringTheDocumentation, RestructureTheWiki
  • Use WikiDocs related pages for WikiDocs work
  • Think about translating documentation. This is a long term objective. Here's a partial copy of a private mail by DonRedman, with some interesting thoughts:
    I believe this does not make sense before MB has language sub-communities. MB is still too small for that. I would not start to translate documentation. This is an enormous, tedious, and never-ending task, and in the worst case nobody will use your work. So, if you *want* to start this, I'd suggest you build up a French sub-community first. With some nice welcome-pages and stuff. *Then* if there are a few people around (not under six active and over a dozen casual contributors, a few active French forum threads, and a feeling of "we") the french pages will probably start to grow all by their own. That is the moment to recognise. Then you push a lot of energy and enthusiasm into it.
    [...]
    French and German are best candidates for this, although French are less used to do everything in English (which is an advantage here).
  • Update WikiDocs related pages (attachments, includes, cards, etc. Also see MoinMoin 1.5 migration) (dmppanda's mess)

Things here for some reason :-)

Orphaned redirects (non personal pages)

Some of them may be used by tagger clients:

  • CapitalizationStandardFrisian
  • DanishCapitalisationStandard
  • ArtistNameStyle
  • ChoralWorksNamesTranslations
  • !SpecialUUIDs
  • AR