This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Some notes on the Wiki


On Mon, 2005-07-11 at 13:09 -0700, Robert Thorpe wrote:
> >     I believe the Wiki is an invaluable documentation tool, precisely
> >     because it allows such an unencumbered contribution process.
> >    
> > I agree.  I wasn't suggesting that the Wiki has no value, but rather
> > that it's not a substitute for the more formal documentation.  Were it
> > not for copyright issues, one could view the Wiki as an ongoing draft
> > process for the documentation.
> 
> A comment from a user...
> 
> Please, please, please don't move GCC internals documentation to a Wiki.
> 
Nobody has suggested that we wouldn't ship docs.

> Even to users the internals documentation is useful.  It's useful when trying to find out why GCC is doing the things it does with the code given to it, it indicates where to look to find things in the source. 

>  This would be much harder if it were a wiki, in particular finding information on the version of GCC you're using would be much more difficult.

However, this isn't true.  The wiki stores every version of a page. We
could make sure we know what versions of the wiki pages refer to what
releases, and link them accordingly.


> 
> Also, a web-browser is much slower than an info-browser, especially when doing searchs.

You must be close to the only user i've met who uses the info browser :)

> 
> 
> 
> 


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]