Daniel Berlin <[EMAIL PROTECTED]> writes:

| On Sun, 2005-07-10 at 19:31 +0200, Gerald Pfeifer wrote:
| > I noticed that the Wiki is getting more and more of a third place where
| > to find documentation in addition of gcc/doc and wwwdocs, and a parallel
| > universe at that, with quite some duplication and inconsistencies.
| 
| Have you not yet discovered that this is because people find the
| documentation we have to be hard to work with, and submitting patches to
| write in texinfo and whatnot to be a pain in the ass? 


I disagree with the notion that because our current documentation is
imperfect, we shall move the corrected one to the Wiki page.  I think
we've gotten too far in putting valuables bits of GCC outside our main
documentation repository.

[...]

| However, the fact that he found the current documentation *entirely
| worthless* enough to write a 104 page document on how everything
| actually worked should tell us maybe there is something wrong with our
| documentation implementation, what we cover, and how we cover it.

It tells us that the documentation is inaccurate; it does not tell us
that we ought to move it to the Wiki. 

[...]

| I find it sad that you are complaining that people have created a
| resource *they* find useful, instead of one that *we think they should
| find useful*.

The issue is not complaining that people do useful things.  Rather,
whether the updated and and more useful documentation of GCC shall be
moved outside GCC main docuementation sources.  


-- 
                                                       Gabriel Dos Reis 
                                           [EMAIL PROTECTED]

Reply via email to