-------- Original Message -------- Subject: Re: [Box-Admins] please add "Documentation" category in Mantis From: Hannes Hirzel hannes.hirzel@gmail.com Date: Thu, August 26, 2010 12:05 am To: Ken Causey ken@kencausey.com Cc: Squeak Hosting Support box-admins@lists.squeakfoundation.org, Casey Ransberger casey.obrien.r@gmail.com
On 8/25/10, Ken Causey ken@kencausey.com wrote:
As requested I have added a 'Documentation' category to the 'Squeak' project at http://bugs.squeak.org/ . Is there a user to which all new Documentation issues should be initially assigned by default? Also note that we also have a 'HelpSystem' category that was previously added and I suspect there is going to be a little tension between whether textual changes to the help text provided by HelpSystem go under the Documentation or HelpSystem categories; you may wish to give this some thought and let me know if I can make any appropriate changes.
Yes, we should give this some thought.
Solution 1) Maybe we should just stick with the category 'HelpSystem' and only use that.
Solution 2)
We consider 'Documentation' to be the more general term which we assign it the task is not related to the HelpSystem (the HelpBrowser by Thorsten)
I'm inclined to 1) to keep things simple until we get up to speed, then we could start switching to 2) or something else.
What do you think?
--Hannes
It's of no great matter to me, but my first choice would be to use HelpSystem for changes to HelpSystem itself, by which I mean infrastructure (aka code) changes, and then have all changes that represent actual user consumed documentation in Documentation. That said, I know little about HelpSystem and how changes to the HelpSystem text are done and perhaps my idea makes no sense at all.
In any case, ultimately what will matter is what those who submit reports think is the correct category in each case. The category can be changed of course, but it gets to be a bit annoying to buck the trend.
Ken
box-admins@lists.squeakfoundation.org