Date: Sun, 17 Aug 2008 14:28:59 +0200 From: Gabor PALI <pgj@FreeBSD.org> To: Hiroki Sato <hrs@FreeBSD.org> Cc: gabor@kovesdan.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: <48A8198B.2010509@FreeBSD.org> In-Reply-To: <20080817.204750.78468138.hrs@allbsd.org> References: <200808162142.m7GLgaAQ086124@repoman.freebsd.org> <20080817.073048.238614512.hrs@allbsd.org> <48A75B1A.7060809@FreeBSD.org> <20080817.204750.78468138.hrs@allbsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Hiroki Sato wrote:
> moving only the team information into www does not agree with the
> reason why we have article/contributors.
I see. Well... According to revision 1.1 [1] (by murray and nik):
"Combine parts of Chapter 21 and Appendix D from the FreeBSD Handbook
into a separate 'Contributors' article so that everything is in one
place. This was done for various reasons :
* This information is way out of scope for the Handbook.
* When we talk about "Contributors" to FreeBSD or developed by "A
large team of individuals" on the web site we can point the user
to a complete document on our web page rather than two separate
chapters in the Handbook.
* We can create a plain-text 'CREDITS' file from this SGML and put
it in /usr/share/misc or similar for all FreeBSD installs if that
is desired."
It was full of outdated and out of synch information, but there is
always place for ideas for a better a documentation, I think.
> And in a long term, maybe we should merge www and doc into a single
> repository (like www/en -> doc/en_US.ISO8859-1/htdocs or so) because
> of making reuse of information easier.
I support it. When do you think this process could be started? Are
there any actual obstacles?
> what do you think about adding files including who it is on per
> developer basis? [..] Most of member descriptions of teams/hats can
> be generated from the files, and also the traditional first commit by
> a new committer can be simplified.
I am fond of this kind of approach ;) For example, mentors could only
send a file like you attached to their mentees to fill up in advance. I
would be happy to see something like this.
What do you think will be needed to implement this and get the ball rolling?
:g
[1]
http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/articles/contributors/article.sgml?f=h;rev=1.1
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?48A8198B.2010509>