Re: doc maintainer questions

[Gerald Pfeifer <gerald at pfeifer dot com>]

[ Old e-mail alert ]

On Sat, 19 Dec 2015, David Wohlferd wrote:
> I have been discussing adding some content to the basic asm docs. As part of
> this work, I want to add a discussion of "How to convert basic asm to extended
> asm."  However it doesn't seem like this is a good fit for the User Guide.
> This is both because the UG doesn't generally talk about "How To" write code,
> and because the text may need updates more often than the UG gets released.

For the latter, could referring to gcc.gnu.org/onlinedocs (in particular
the trunk version there) be a viable option?  

That gets updated daily, so not a question of waiting for the next 
release.

> 1) Is it appropriate for the UG to link to sections in the wiki?  I 
> see that we do, but should we?

Generally, I think that is fine.  It does require Internet access
and you run into the opposite of what you describe above (the Wiki
might have moved to coverage of a later version of GCC), but then
so does what I described at the beginning of this message.

Generally, I also think that we should not spread things across too
many places, and our documentation should be mostly self contained.

(The particular use case you had in mind, seems fine for the Wiki
or the web pages -- and I'm thinking of our porting_to.html pages
that we have had for the last couple of major releases.)

Gerald