cvs commit: doc/en_US.ISO8859-1/articles/committers-guide article.sgml doc/en_US.ISO8859-1/articles/releng article.sgml doc/en_US.ISO8859-1/books/developers-handbook/policies chapter.sgml

[Gabor Kovesdan]

Hiroki Sato ha scritto:
> Gabor Pali <pgj at FreeBSD.org> wrote
>   in <200808162142.m7GLgaAQ086124 at repoman.freebsd.org>:
>
> pg> pgj         2008-08-16 21:42:36 UTC
> pg>
> pg>   FreeBSD doc repository
> pg>
> pg>   Modified files:
> pg>     en_US.ISO8859-1/articles/committers-guide article.sgml
> pg>     en_US.ISO8859-1/articles/releng article.sgml
> pg>     en_US.ISO8859-1/books/developers-handbook/policies
> pg>                                                        chapter.sgml
> pg>   Log:
> pg>   - Take the outdated sections of articles/contributors out of circulation
> pg>     in doc/
> pg>
> pg>   Discussed with: joel
> pg>   Reviewed by:    joel
> pg>   Approved by:    gabor (mentor)
>
>  What is the reason why choosing not updating the article?  I do not
>  think simply leaving the old description is a good idea, and we need
>  a discussion about which should be maintained before replacing the
>  existing links because currently administration.sgml and
>  contributors/ article have some duplicated information.
>   
It was discussed a long ago in a thread started by Joel, and before this 
particular change, as well. Gabor sent a mail to doc@ with proposed 
changes and nobody objected in removing these parts. One of the other 
suggestions was to try to make one list and generate both the web pages 
and the article from that one. That might be a better solution, but the 
doc and the www tree should be able to build separately, so I think it 
would be complicated to implement. I think there are other overlapping 
parts, like &os; and the current release entities. Maybe it would make 
sense to separate them to a common part somehow and use it for the web 
and the doc?

Gabor