[documentation] Proposal for handbook maintenance automation
Johan Forngren
johan at forngren.com
Thu Aug 9 14:28:05 UTC 2007
On 8/8/07, Steven Peck <sepeck at gmail.com> wrote:
>
> The handbooks are a wiki for people with appropriate rights. There
> are 98 of these people currently. http://drupal.org/node/109372
>
> <snip>
>
> Before moderation was taken out, I did in fact open the handbook up to
> editing to a wider role. The moderation behavior was very annoying
> but the simple fact is page vandalism was worse then the above
> statistic.
How about letting anyone edit docu pages, the catch being that they have to
be moderated by docu members? In that way it's easily for users to fix
pages, and docu maintainers could easily accept/trash change with a click.
On 8/8/07, Laura Scott <laura at pingv.com> wrote:
> >
> > On Aug 8, 2007, at 11:33 AM, Kieran Lal wrote:
> > I think all the documentation should be a wiki. Click here to
> edit. Give
> > admins the ability to lock pages, were necessary.
> >
> > The current status of having 50 comments on a page for something as
> critical
> > how to upgrade your module to the next API version, is completely
> > unacceptable. We are forcing companies and admins to spend collectively
> > millions of dollars on upgrading their sites between versions with
> > inconsistent and unclear documentation.
> >
> > Agree on this 100%.
> >
> > Something sepeck and I discussed at OSCMS was that all the versions are
> > intermingled, and that ideally we would have handbook views by version
> > number, and done in a way that avoids massive node duplication in order
> to
> > effect hierarchy.
> >
> > The handbooks are a particularly tough challenge. Wonder if what we
> really
> > need are tabbed views for each page, with each tab offering potentially
> > version-specific info. Even in a wiki, that approach might be helpful
> from a
> > usability standpoint. The tagging alone gets us part of the way there.
> >
> > Laura
> >
> >
> > --
> > Pending work:
> > http://drupal.org/project/issues/documentation/
> > List archives:
> > http://lists.drupal.org/pipermail/documentation/
> >
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>
--
Regards,
Johan Forngren :: http://johan.forngren.com/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20070809/eb1a53b3/attachment.htm
More information about the documentation
mailing list