[Box-Admins] please add "Documentation" category in Mantis

[Ken Causey]

> -------- Original Message --------
> Subject: Re: [Box-Admins] please add "Documentation" category in Mantis
> From: Hannes Hirzel <hannes.hirzel at gmail.com>
> Date: Thu, August 26, 2010 12:05 am
> To: Ken Causey <ken at kencausey.com>
> Cc: Squeak Hosting Support <box-admins at lists.squeakfoundation.org>, 
> Casey Ransberger <casey.obrien.r at gmail.com>
> 
> 
> On 8/25/10, Ken Causey <ken at 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