Re: [Plone-docs] Document comments used as support forums

[Steve M. <st...@dc...>]

Way back at the DocComm sprint, it was decided — but never implemented
— that we wanted to replace the comments with a link to a tracker for
ticket filing for inaccurate, misleading or inadequate documentation.
The idea was to discourage "help me" comments while helping the doc
team take responsibility for quality control.

If we develop a more free-wheeling policy for a portion of the
documents, those will then be editable in place by anyone with a
login. No need for comments there either.

On Sun, Nov 23, 2008 at 1:15 PM, Israel Saeta Pérez <duk...@gm...> wrote:
> On Sun, Nov 23, 2008 at 9:45 PM, Alexander Limi  wrote:
>> On Sun, 23 Nov 2008 08:10:20 -0800, Martin Aspeli
>> <opt...@gm...> wrote:
>>
>>> Comments on plone.org were intended as a way to provide additional
>>> comments or feedback, not ask for more help. I think it's inevitable
>>> that some people will ask for help, but in general I think we should
>>> discourage that use case.
>>
>> …or, if we decide to support it, at least it has to send CC to a list that
>> has some people on it, so the original author isn't the only one that gets
>> notified.
>
> But this would involve either
>  1) providing a way to route mailing list responses back to the
> comments for the reader to see them or
>  2) the comment's author being suscribed to the plone-users mailing-list
>
> Anyways, I think that if they're used correctly (IMO errata,
> suggestions, improvements), posting documentation comments to the
> plone-docs (or plone-docs-comments list, or whatever) would be helpful
> for the documentation team to spot any incoming comments and integrate
> them if neccessary. But I guess this would have to wait for plone.org
> Plone 3 integration.
>
> -- israel
>
> -------------------------------------------------------------------------
> This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
> Build the coolest Linux based applications with Moblin SDK & win great prizes
> Grand prize is a trip for two to an Open Source event anywhere in the world
> http://moblin-contest.org/redirect.php?banner_id=100&url=/
> _______________________________________________
> Plone-docs mailing list
> Plo...@li...
> https://lists.sourceforge.net/lists/listinfo/plone-docs
>



-- 

Steve McMahon
Reid-McMahon, LLC
st...@re...
st...@dc...