From 6d33c08c0485f5b24879d06d3a5f5a7bcc50f3e6 Mon Sep 17 00:00:00 2001 From: "Simon L. B. Nielsen" Date: Thu, 16 Jun 2011 19:40:12 +0000 Subject: [PATCH] Clean up the "Administrative Details" section of committer's Guide: - Force column width to improve rendering. - Remove a number of pieces of information which is either obsolete or just not important. This includes removing reference to using telnet which was already obsolete when I got a commit bit in 2003... - Point people at freefall. - Remove the hardcoded lists of members of cvsadm and GNATS admins - this just duplicated administration.html and new committers should not need to bug the two teams so often that they need to be pointed out more than the many other active administrative teams. [1] - Point at dcvs and pcvs for CVS repo's, as those are still in use by developers. - Don't use entities for internal mailing lists which expands to the names as the result is just confusing and not useful. This part should probably be changed to be a section with more text instead of trying to include most info inside a table. - Add information about portmgr monthly reports. - Add a few links to some useful internal pages with more information. - Misc minor text cleanup. Discussed with: linimon, gavin [1] --- .../articles/committers-guide/article.sgml | 77 +++++++++---------- 1 file changed, 38 insertions(+), 39 deletions(-) diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml index 2a4db53880..5e302cf9e7 100644 --- a/en_US.ISO8859-1/articles/committers-guide/article.sgml +++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml @@ -60,52 +60,44 @@ + + - - Main CVS Repository Host - ncvs.FreeBSD.org - - - - Main Subversion Repository Host - svn.FreeBSD.org - - Login Methods &man.ssh.1;, protocol 2 only - Main CVSROOT - - ncvs.FreeBSD.org:/home/ncvs (although also see ). - + Main Shell Host + freefall.FreeBSD.org Main Subversion Root - svn+ssh://svn.FreeBSD.org/base (although also see ). + svn+ssh://svn.FreeBSD.org/base (see also ). - Main &a.cvsadm; - &a.peter; and &a.simon;, as well as &a.joe; and &a.marcus; for - ports/ + Main CVSROOT's + + + dcvs.FreeBSD.org:/home/dcvs, + pcvs.FreeBSD.org:/home/pcvs + (see also ). + + - &a.bugmeister; - &a.gavin; &a.linimon;, &a.remko;, and &a.vwe . - + Internal Mailing Lists - - Mailing Lists - &a.doc-developers;, &a.doc-committers;; - &a.ports-developers;, &a.ports-committers;; - &a.src-developers;, &a.src-committers;. (Each project + developers (technically called all-developers), + doc-developers, doc-committers, ports-developers, + ports-committers, src-developers, src-committers. + (Each project repository has its own -developers and -committers mailing lists. Archives for these lists may be found in files /home/mail/repository-name-developers-archive @@ -125,11 +117,10 @@ - Noteworthy CVSup Tags - - RELENG_7 (7.X-STABLE), - RELENG_8 (8.X-STABLE), - HEAD (-CURRENT) + Ports Management Team monthly + reports + /home/portmgr/public/monthly-reports + on the FreeBSD.org cluster. @@ -146,16 +137,24 @@ - It is required that you use &man.ssh.1; or &man.telnet.1; - with Kerberos 5 to connect to the project hosts. For - &man.ssh.1; only protocol 2 is allowed. - These are generally more secure than plain &man.telnet.1; or - &man.rlogin.1; since credential negotiation will always be - encrypted. All traffic is encrypted by default with &man.ssh.1;. - With utilities like &man.ssh-agent.1; and &man.scp.1; also - available, &man.ssh.1; is also far more convenient. If you do + It is required that you use &man.ssh.1; + to connect to the project hosts. + If you do not know anything about &man.ssh.1;, please see . + + Useful links: + + + FreeBSD + Project Internal Pages + + FreeBSD + Project Hosts + + FreeBSD + Project Administrative Groups +