History:Wiki Wardening: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(@dmppanda (Imported from MoinMoin))
(a few notes (Imported from MoinMoin))
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]]).
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!).


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 191: Line 191:
**: clean, transcluded
**: clean, transcluded
**: some work to do, transclusion ASAP
**: some work to do, transclusion ASAP

Raw ideas:
* suggestion for a new transclusion interface on [[Ticket:1962|1962]]
* propose the use of "transclusion zones" and fine grained transclusion rights management


==Open Questions==
==Open Questions==
Line 196: Line 200:
* Category nesting (murdos).
* Category nesting (murdos).
* think of a masterplan about categories.
* 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==
==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)

Revision as of 04:02, 7 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). 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.

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 The relevant ticket is 2320.

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

WikiWardens on this

All! (note that Europeans have the best choco)

WantedPages

Problem

In its current state, WantedPages 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)!
  • 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 inhibate a camelcased link, use !BogusLink.
  • to inhibate a bracketted link, use entities instead of brackets: ["Bogus Link"]

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

Maybe we should have also:

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 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 superseded 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:

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

Rehaul Categories

Update WikiDocs related docs

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

Historical pages

Create an entry point like HistoryOfMusicBrainz 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

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

  • More WikiTags:
    • ProveMeWrong: some sort of 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.
    • FixMeBeforeTransclusion (or PreventTransclusion?): self-explicit. Use this to remember to fix that little sentence lost somewhere in your WikiPage that you don't want to see in your WikiDoc.
  • 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
  • "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)."

Bugs!!!

Attention.png Urgent TODO: triage this and report to Ruaok as he's willing to help us now.

  • 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
  • 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)
    • I need some more time to think again about what to do with things under Orphaned redirects. As for the other orphans, the reason is that they are IMHO cluttering the OrphanedPages view with unneeded content, and linking to them from here remove them from that view (which makes OrphanedPages more usuable as a working tool). But maybe we can use another hack, or move them somewhere else (they used to live in my personal page). -- dmppanda 19:35, 06 April 2007 (UTC)
      • Ok I now understand :) See my comment below about broken backlinks in this version of MoinMoin. IMHO we should move them to a temporary subpage to not clutter this page and wait for MoinMoin 1.5. -- murdos 21:56, 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)
    • They are no longer in OrphanedPages... because we link to them from here ;) -- dmppanda 19:35, 06 April 2007 (UTC)
      • Don't worry they are all linked from MusicBrainzBio, but you've encoutered the bug DonRedman was talking about here: MoinMoin 1.3 has problems with backlinks when using [:SomeThing: SomeThingElse] ;-) -- murdos 21:56, 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):


(?)