[Opensim-dev] Tracking Documentation in Mantis

[Sean Dague]

Rob Smart wrote:
>>> Thoughts ?
>> Do you mean for documentation in code, or in the wiki?  If it's for the
>> code, I think mantis is appropriate.  If it's in the wiki I think there
>> are better ways to do that.
>>
> 
> I meant documentation in the wiki. I'm open to suggestions of how to better
> track and request entries/changes on the wiki. However at the moment i feel
> documentation is lacking currently
> and bringing the request/recognition mechanisms inline with those for code
> contribution may help.
> 
> The problem  with normal wiki usage is that yes you can add comments on the
> comment pages but someone has to actively go and look for them. rather than
> doing a quick priority sort on documentation
> in Mantis, plus the IRC updates help give peripheral vision of  updates
> occuring.

Being the master and creator of the osmantis bot, it would be relatively
simple to pull in the rss changelog feed and add that to our IRC "HUD".
 I'm definitely a fan of highlighting people's contributions.  It's the
reason we feed the info we currently do into IRC.

When you tag {{content}}, {{obsolete}}, {{needsexample}} on a page, it
automatically gets added here: http://opensimulator.org/wiki/Category:Todo

We can definitely add more tags for other levels of refinement as well,
like {{nopage}}, {{featured}} (to show off what a really good page looks
like, and others.  I finally got the hang of the macro language to make
those things do what we want.

Granted, the whole macro tagging is quite new, so it will take a little
bit to get into the workflow, but I really think that managing the wiki
with the wiki is probably our best road to success.

	-Sean

-- 
Sean Dague / Neas Bade
sdague at gmail.com
http://dague.net


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 252 bytes
Desc: OpenPGP digital signature
URL: <http://opensimulator.org/pipermail/opensim-dev/attachments/20081002/038c6ab9/attachment-0001.pgp>