Re: [avr-gcc-list] gcc-avr/avr-libc wiki

[David McNab]

On Fri, 2007-03-02 at 07:23 -0500, Graham Davies wrote:
> > Wikipedia is full of problems - systemic bias, errors, conflicting
> > agendas etc, but it's a heck of a lot better than having no wikipedia
> > at all.
> 
> Wikipedia is not "full" of problems.  Pages with bias are marked as such.

Some pages are marked 'neutrality is disputed'. Many other pages reflect
a clear systemic bias; any attempts to edit out this bias and restore an
NPOV get promptly reverted by people with personal agendas who place
these pages on their watchlists. For subjects related to
non-controversial material issues, the systemic bias is less than those
with subjects where multiple points of view exist, and the wikipedia
community as a whole tend to hold one viewpoint.

> A vigorous community continuously corrects errors.  If we thought we could 
> produce something at the level of quality of Wikipedia and with a similar 
> assurance that it would last I would help as much as possible.  But avrwiki 
> does not look like that to me.

Not yet. But it only takes low-moderate effort from each person to get
the avr-gcc section up to a good standard.

> I'm still concerned that helping with the "golden" documentation might be an 
> even better idea, but I don't know how feasible that is.  Or, would the 
> maintainers of the "golden" documentation abandon that in favor of the Wiki?

The 'golden' documentation, as you call it, consists mainly of the
Doxygen-generated docs, with a few hand-written helper pages tossed in.

The helper pages really need to be reorganised and added to. For
example, entire subjects are covered in brief in the FAQ, where they
should arguably be given their own pages and fleshed out in more detail.

The advantage of a wiki is that it's a great medium for a lot of folks
to do a little work each, instead of privileged-access html pages where
a few folks have to do a lot of work.

Cheers
David


> 
> Graham.
> 
> 
> 
> 
> _______________________________________________
> AVR-GCC-list mailing list
> address@hidden
> http://lists.nongnu.org/mailman/listinfo/avr-gcc-list