History:Wiki Wardening: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(sortname (Imported from MoinMoin))
((Imported from MoinMoin))
Line 7: Line 7:
==Purpose==
==Purpose==


Early 2007, new efforts are 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]]).
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]]).


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]].
Line 46: Line 46:
* broken sigs: some [[WikiZen]] have troubles spelling their own names :-) ([[User:Ruaok|Ruaok]], among other) - help them for their own good!
* broken sigs: some [[WikiZen]] have troubles spelling their own names :-) ([[User:Ruaok|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.
* 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 inhibate 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 "inhibate" anything you see there! Specially:
* don't inhibate sigs for wiki editors without personal pages (they might want to create one later)!
* don't inhibate sigs for wiki editors without personal pages (they might want to create one later)!
<ul><li style="list-style-type:none">Or should we create an empty page for them? [[Answer Me|AnswerMe]] please. -- [[User:dmppanda|dmppanda]] 15:28, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">Or should we create an empty page for them? [[Answer Me|AnswerMe]] please. -- [[User:dmppanda|dmppanda]] 15:28, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">Empty page would be useless. So for me it is not needed. -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>
</ul>
</ul>
* think twice before inhibating 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]].
* when in doubt, just leave them alone!
* when in doubt, just leave them alone!


Line 84: Line 86:
Maybe we should have also:
Maybe we should have also:
* [[Needs Category|NeedsCategory]]
* [[Needs Category|NeedsCategory]]
<ul><li style="list-style-type:none">Ok for this one, [[Needs Categorizing|NeedsCategorizing]] is maybe better? -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>
* [[Needs Spelling Check|NeedsSpellingCheck]]
* [[Needs Spelling Check|NeedsSpellingCheck]]
<ul><li style="list-style-type:none">Not sure about this one: just spell check immediately :p -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>


-- [[User:dmppanda|dmppanda]] 15:28, 05 April 2007 (UTC)
-- [[User:dmppanda|dmppanda]] 15:28, 05 April 2007 (UTC)
Line 111: Line 117:
* 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).
* 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).
<ul><li style="list-style-type:none">Or should we? Empty pages, orphaned, unedited since the wiki migration: is there a point in keeping these? Please [[Answer Me|AnswerMe]] -- [[User:dmppanda|dmppanda]] 17:09, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">Or should we? Empty pages, orphaned, unedited since the wiki migration: is there a point in keeping these? Please [[Answer Me|AnswerMe]] -- [[User:dmppanda|dmppanda]] 17:09, 05 April 2007 (UTC)
<ul><li style="list-style-type:none">As said above, I don't see the point to have empty page. -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>
</ul>
</ul>


Line 156: Line 164:
==WikiNewbies==
==WikiNewbies==


Create a page for [[Wiki Newbie|WikiNewbie]]<code><nowiki></nowiki></code>s with good practice guidelines on this wiki. -- [[User:murdos|murdos]] 16:52, 05 April 2007 (UTC)
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.


With a (short) checklist of things to verify (intertwingling, categories, spelling, etc).
With a (short) checklist of things to verify (intertwingling, categories, spelling, etc).
Line 172: Line 180:
==Historical pages==
==Historical pages==


<ul><li style="list-style-type:none">Create an entry point like [[History Home|HistoryHome]] for historical pages. Create special categories for historical proposal, historical guidelines, ...
Create an entry point like [[History Home|HistoryHome]] for historical pages. Create special categories for historical proposal, historical guidelines, ...
</ul>


==Promote transclusion==
==Promote transclusion==
Line 179: Line 186:
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)
<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)
<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)
</ul>
</ul>
</ul>


Split documentation into responsabilities zones.
Split documentation into responsibilities zones.
* [[User:dmppanda|dmppanda]]:
* [[User:dmppanda|dmppanda]]:
**: clean, transcluded
**: clean, transcluded
Line 205: Line 214:
* differentiate restructuring tasks (defining categories, renaming, ...) and improving content tasks (updating docs, ...)
* differentiate restructuring tasks (defining categories, renaming, ...) and improving content tasks (updating docs, ...)
* find some documentation about FullSearch macro (where the heck is it located?)
* find some documentation about FullSearch macro (where the heck is it located?)
<ul><li style="list-style-type:none">[[MoinMoin:HelpOnSearching|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... :| -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>
* move my ass to have Label doc in a decent state
* 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.
* 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 differenciation 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:)
Line 223: Line 234:


* [[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...)
* [[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]]
* Use [[WikiDocs]] related pages for [[WikiDocs]] work


==Bugs!!!==
==Bugs!!!==


* [[Image:Attention.png]] [[Ticket:2320|2320]]: Upgrade moin
* [[Image:Attention.png]] [[Ticket:2320|2320]]: Upgrade [[Moin Moin|MoinMoin]]
* [[Image:Attention.png]] [[Ticket:2672|2672]]: Cards and transclusion behavior
* [[Image:Attention.png]] [[Ticket:2672|2672]]: Cards and transclusion behavior
* [[Ticket:1962|1962]]: Transclusion hasn't work so well so far, lack of manpower
* [[Ticket:1962|1962]]: Transclusion hasn't work so well so far, lack of manpower
Line 234: Line 247:
* [[Ticket:1530|1530]]: Show transcluded wiki page in user profile in main site.
* [[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">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>
</ul>
* [[Ticket:1489|1489]]: Wiki transclusion data in wrong place
* [[Ticket:1489|1489]]: Wiki transclusion data in wrong place
Line 240: Line 255:


==Things here for some reason :-)==
==Things here for some reason :-)==

<ul><li style="list-style-type:none">Could you precise the reason, or drop all these things, please? The page is already quite long ;-) -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>


===Orphaned redirects (non personal pages)===
===Orphaned redirects (non personal pages)===
Line 252: Line 270:


===Links to pages that I don't want to see anymore in OrphanedPages===
===Links to pages that I don't want to see anymore in OrphanedPages===

<ul><li style="list-style-type:none">But these pages are '''not''' in [[Orphaned Pages|OrphanedPages]]... I don't understand... -- [[User:murdos|murdos]] 00:07, 06 April 2007 (UTC)
</ul>


Bios:
Bios:

Revision as of 00:07, 6 April 2007

WikiWardening > WikiWardening | WikiWardens

Content

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 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).

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

Obtain MoinMoin upgrade

Problem

We are stuck with an old MoinMoin full of deranging bugs and badly outdated.

Objective

Collect enough choco to bribe Ruaok so he updates MoinMoin to 1.5.x.

  • but stop spamming him about this :p -- dmppanda 17:10, 05 April 2007 (UTC)

Relevant ticket is 2320.

WikiWardens on this

All!

WantedPages

Problem

In its current state, this is unusable. Counts around 877.

Objective

Bring it down below ~500 links.

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 "inhibate" anything you see there! Specially:

  • don't inhibate sigs for wiki editors without personal pages (they might want to create one later)!
  • Or should we create an empty page for them? AnswerMe please. -- dmppanda 15:28, 05 April 2007 (UTC)
    • Empty page would be useless. So for me it is not needed. -- murdos 00:07, 06 April 2007 (UTC)
  • think twice before inhibiting things that looks like BadWikiName of otherwise valid WantedPages.
  • when in doubt, just leave them alone!

Tips:

  • to inhibate a camelcased link, use !BogusLink.
  • to inhibate a bracketted link, use entities instead of brackets: ["Bogus Link"]

WikiWardens on this

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, and at least mark these pages with the relevant WikiTags:

Maybe we should have also:

  • Not sure about this one: just spell check immediately :p -- murdos 00:07, 06 April 2007 (UTC)

-- dmppanda 15:28, 05 April 2007 (UTC)

... or at best, do the work immediately.

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.
  • 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).
  • Or should we? Empty pages, orphaned, unedited since the wiki migration: is there a point in keeping these? Please AnswerMe -- dmppanda 17:09, 05 April 2007 (UTC)
    • As said above, I don't see the point to have empty page. -- murdos 00:07, 06 April 2007 (UTC)

You may want to take a look at AbandonedPages and OrphanedPages (and also to Stub) 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 superceded by their equivalent (better and maintained) pages at WikiPedia.

Tips for WikiWardens not member of the PageDeletorGroup:

  • 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 somebody in PageDeletorGroup so that he deletes the page effectively

Tips for members of PageDeletorGroup:

  • do a full text search on the wiki to list all links pointing to the DeletedPage: something like [[FullSearch(linkto:DumbPage)]]
  • replace or inhibate all links
  • 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.

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).

Rehaul Categories

Update WikiDocs related docs

Attachments, includes, cards, etc. Also see MoinMoin 1.5 migration.

Historical pages

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

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)

Split documentation into responsibilities zones.

  • dmppanda:
    • clean, transcluded
      some work to do, transclusion ASAP

Open Questions

  • Category nesting (murdos).
  • think of a masterplan about categories.

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:)
    • 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

Bugs!!!

  • Attention.png 2320: Upgrade MoinMoin
  • Attention.png 2672: Cards and transclusion behavior
  • 1962: Transclusion hasn't work so well so far, lack of manpower
  • We need to prove that wrong! -- dmppanda 15:48, 05 April 2007 (UTC)
  • 1799: WikiDocs does not produce valid XHTML
  • 1530: Show transcluded wiki page in user profile in main site.
  • 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. -- dmppanda 15:48, 05 April 2007 (UTC)
    • I agree too. But you should definitely add your comment on the ticket, not here ;) -- murdos 00:07, 06 April 2007 (UTC)
  • 1489: Wiki transclusion data in wrong place
  • 1112: Wiki Transclusion should check for correct WikiName and Revision Number
  • Attention.png 849: Provide translations for key documentation

Things here for some reason :-)

  • Could you precise the reason, or drop all these things, please? The page is already quite long ;-) -- murdos 00:07, 06 April 2007 (UTC)

Orphaned redirects (non personal pages)

Some of them may be used by tagger clients:

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

Links to pages that I don't want to see anymore in OrphanedPages

  • But these pages are not in OrphanedPages... I don't understand... -- murdos 00:07, 06 April 2007 (UTC)

Bios:

Personal pages redirects:

Personal pages updated at least once in 2007 - no backlinks on the wiki (orphaned):

Personal pages updated at least once in 2006 - no backlinks on the wiki (orphaned):

Personal pages untouched since the wiki migration - no backlinks (orphaned):


(?)