Date: Sun, 17 Aug 2008 12:40:30 +0200 From: Gabor Kovesdan <gabor@kovesdan.org> To: Hiroki Sato <hrs@FreeBSD.org> Cc: pgj@FreeBSD.org, doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: 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 Message-ID: <48A8001E.1000104@kovesdan.org> In-Reply-To: <20080817.073048.238614512.hrs@allbsd.org> References: <200808162142.m7GLgaAQ086124@repoman.freebsd.org> <20080817.073048.238614512.hrs@allbsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Hiroki Sato ha scritto: > Gabor Pali <pgj@FreeBSD.org> wrote > in <200808162142.m7GLgaAQ086124@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?48A8001E.1000104>