Re: splitting up docs dir (was Re: Doxygen - another sample,preliminary comments)

[Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>]

On Thu, 30 Nov 2000, Phil Edwards wrote:
> For a short-term start, Gerald and I would like to remove from v3/docs:
>
>     download.html
>     footer.ihtml
>     header.ihtml
>     links.html
>     mail.html

Mid-term I'd also like to see links.html be merged into
<http://gcc.gnu.org/readings.html>, to avoid redundancy and have a
single, full-fledged source with pointers.

> I myself would also like to remove index.html, status.html, and
> thanks.html, but haven't discussed that with anyone yet.

status.html does not seem to be up-to-date, or am I wrong?

>    3)  keep the "inner" pages in v3/docs[/html] and either
>       a)  remove them from wwwdocs, or
>       b)  occasionally push them to wwwdocs and live with the
>           inconsistency, or
>       c)  make the v3/docs pages available over *some* webserver, and
>           link to them from the "main" pages; this would mean going
>           partially back to the auto-checkout scheme we had previously
>   4)  when users ask the hard questions, we would refer them to the
>       "inner" pages on their local disk, since those are the ones we are
>       constantly updating (assuming they're using cvs)

As a rule of thumb it's nearly always better to refer them to web
versions, because that's for *sure* the most up-to-date we have. ;-)

I'd strongly prefer to remove the duplicates of the "regular" web pages
ASAP and I'll continue to ponder a bit about the technical documentation.
Perhaps I'll have an idea... ;-)

Gerald
-- 
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/