[mb-style] WikiDocs for StyleGuidelines?

Age Bosma agebosma at home.nl
Tue Nov 7 10:00:04 UTC 2006


Don Redman wrote:

>>
>> The status of a specific page should be made _very_ clear. The current 
>> icon and line of text is far to easy to overlook. I suggest to put a 
>> nice box around the status line with a black (#3F3F3F) border and 
>> different background colours for each status. I don't know how many 
>> possible statuses we are dealing with throughout the wiki but simple 
>> colours like green (#99FF99) for 'official', blue (#9999FF) for 
>> 'working draft' and red (#FF9999) for 'deprecated' come to mind.
>> Can we use templates in our wiki at the moment? If yes than it 
>> shouldn't be hard to add or change the status of a page.
> 
> What exactly do you mean?
> There are some icons that we can use 
> <http://moinmoin.wikiwikiweb.de/HelpOnSmileys>
> 
> I do no know of any existing Macro that would display a box. I guess 
> with some python knowledge it should be easy to create one, though.
> 

I mean templates: http://en.wikipedia.org/wiki/Help:Template

Where we can just put a bit of HTML in a separate template page: <div 
style="border: 1px solid #3F3F3F; background-color: #9999FF; 
font-weight: bold; text-align: center; padding: 0px 10px 0px 10px; 
margin: 10px 0px 10px 0px;"><p style="margin: 4px 0px 4px 
0px;">Deprecated</p></div>

And call the template where needed: {{deprecated}}

So that the previous bit of HTML gets included in that page. This way we 
would get about the same thing I introduced in Devmo: 
http://developer.mozilla.org/en/docs/Template:deprecated_header
Example: 
http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Objects:Function:arity

As far as I can tell, MoinMoin does not support the same kind of 
templates, nor does it allow me to include HTML :-(

> 
>> People should not have to knock on too many doors to get something 
>> done. When there's a specific group of people who are allowed to add 
>> or change something in the wikidocs, you don't want to have to ask 
>> them directly by sending them an e-mail or wait for them to come 
>> online in the IRC channel. Probably the best way to handle this is to 
>> add a ticket to the tracker in a dedicated category when a work is 
>> finished. This way the wiki people don't have to be active in every 
>> discussion all the time and they can just go through each ticket every 
>> now and again.
> 
> If you mean us when reorganizing the wiki, then we do not need tickets. 
> We just watch each other's steps closely. I have just started to 
> reorganize ReleaseAttribute, and would appreciate if someone followed my 
> tracks.
> 
> If you mean how changes get wikidocselt (i.e. the revision in WikiDocs 
> is raised), then this should be easy. If the person who moderates this 
> section of the wiki is subscribed to the page, they get the change 
> emailed and can update the transclusion table. Since official *Style 
> pages do not change too often, that should be feasible.
> 

You mean that as soon as a status on one of the wiki pages changes to 
official the one who is monitoring it should automatically change it to 
a wikidoc (update the transclusion table)?
I think this might be a bit too error-prone. It happens quite often that 
people change something and realize afterwards that they e.g. forgot a 
tiny bit so they start editing again. One of the moderators might have 
already updated the transclusion table in the meanwhile. Because of this 
I thought it would be better to submit a ticket with 'please update this 
page, it's really ready now'.

Age



More information about the Musicbrainz-style mailing list