[pmwiki-users] Documentation update moans

[mike moller]

Well I dunno, apart from a few small snafus that have crept in, have been
apologised for, and will be corrected shortly I really can't see much that's
worth griping about. This whole thing is a live, well supported co-operative
venture as good as, and probably more responsive, than just about anything
I've seen around in the open source arena.

In such a milleu there will always be the odd piece of the jigsaw that fails
to fit by a millimetre or two - the ones that matter get the quick reaction
that is justified by their impact. Minor issues in documentation is quite
another matter and need to be granted a measure of pragmatic leeway. As a
general principle if one finds a problem one can/should fix it. The people
who raise such issues are usually the ones who are effected by them and the
best contribution they can make to the community surely is to "put in the
fix" before it becomes an irritation to others?
-- 
Mike Moller
Lallybroch Alpacas
New Zealand
www.lallybroch.co.nz

On 8/31/06, Patrick R. Michaud <pmichaud at pobox.com> wrote:
>
> On Wed, Aug 30, 2006 at 06:14:09PM +0100, Marc Cooper wrote:
> >
> > I just upgraded from .11 to .18, and am wondering what inspired the
> > following:
> > - FAQ: Red bold text!
> > - Passwords:
>
> Oops.  Apparently in the rush to resolve some other issues, these
> edits slipped past me into the distribution.
>
> Feel free to correct them on pmwiki.org, and they'll be fixed in
> the next release.
>
> > - The 'Other Variables' page has lost a swathe of entries. Some appear
> >   to have moved elsewhere, but some are now absent. For example,
> >   $EnableIMSCaching; $EnableStopWatch; and so on.
>
> I think new pages were created for some of these variables and
> those new pages didn't make it into the distribution.
>
> > One final wish: is there any reason that 'Documentation Index' has line
> > breaks in it? It makes it difficult to scan - although nowhere near as
> > difficult as the Cookbook index, which is just horrible.
>
> In the past people noted that scanning the long lists of items
> without the linebreaks was also difficult to read.  I don't
> have a problem with either approach, so we can vote on it
> here on the listserv.
>
> And I'm hoping to make the Cookbook index more "automatic", as
> demonstrated at http://www.pmwiki.org/wiki/Cookbook/Cookbook-ByCategory .
> This page is slow at the moment (because it has to generate all of
> the category lists individually), but I'm thinking I can create
> a custom formatting function to make it a reasonable speed again.
>
> Pm
>
> _______________________________________________
> pmwiki-users mailing list
> pmwiki-users at pmichaud.com
> http://www.pmichaud.com/mailman/listinfo/pmwiki-users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: /pipermail/pmwiki-users/attachments/20060831/9dd4655f/attachment.html