From a26dd557ebde405111c45ca755aa00501ea1eae2 Mon Sep 17 00:00:00 2001 From: Nik Clayton Date: Sun, 23 Jul 2000 16:22:16 +0000 Subject: Rewrite the abstract. This isn't just a CVS document any more. Shift the information about the repository-meisters in to the first section about CVS. Re-write the list of things that a new committer should do as a numbered list. Mention the existence of the xearth committers' markers file. --- .../articles/committers-guide/article.sgml | 135 ++++++++++++--------- .../articles/committers-guide/article.sgml | 135 ++++++++++++--------- 2 files changed, 152 insertions(+), 118 deletions(-) diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml index a6293c9c30..6899ce8dba 100644 --- a/en_US.ISO8859-1/articles/committers-guide/article.sgml +++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml @@ -16,7 +16,7 @@ - $Date: 2000-07-13 21:07:52 $ + $Date: 2000-07-23 16:22:16 $ 1999 @@ -25,16 +25,10 @@ - Welcome, committer, to the FreeBSD development - team! - - The following docs are provided to orient you on doing CVS - operations on the FreeBSD central repository machine. A basic - familiarity with CVS is already assumed, although CVS - reference information, tutorials, and FAQs can also be found - at: http://www.cyclic.com/CVS/support - - Good luck, and welcome aboard! + This document provides information for the FreeBSD committer + community. All new committers should read this document before they + start, and existing committers are strongly encouraged to review it + from time to time. @@ -111,6 +105,24 @@ CVS Operations + It is assumed that you are already familiar with the basic operation + of CVS. + + The CVS Repository Meisters (Peter Wemm and John Polstra) + are the owners of the CVS repository and are + responsible for any and all direct + modification of it for the purposes of cleanup or fixing some + grievous abuse of CVS by a committer. No one else should + attempt to touch the repository directly. Should you cause some + repository accident, say a bad cvs import or tag operation, do + not attempt to fix it yourself! + Mail or call John or Peter immediately and report the problem to + one of them instead. The only ones allowed to directly fiddle + the repository bits are the repomeisters. Satoshi Asami is also a + repomeister for the ports/ portion of the + tree. Mark Murray is the repomeister for the International + Crypto Repository in South Africa. + CVS operations are usually done by logging into freefall, making sure the CVSROOT environment variable is set to @@ -144,61 +156,66 @@ done. The purpose of a repository copy is to preserve file change history, or logs. We in the FreeBSD Project greatly value the change history CVS gives to the project. + + CVS reference information, tutorials, and FAQs can also be found at: + http://www.cyclic.com/CVS/support + Conventions and Traditions - The CVS Repository Meisters (Peter Wemm and John Polstra) - are the owners of the CVS repository and are - responsible for any and all direct - modification of it for the purposes of cleanup or fixing some - grievous abuse of CVS by a committer. No one else should - attempt to touch the repository directly. Should you cause some - repository accident, say a bad cvs import or tag operation, do - not attempt to fix it yourself! - Mail or call John or Peter immediately and report the problem to - one of them instead. The only ones allowed to directly fiddle - the repository bits are the repomeisters. Satoshi Asami is also a - repomeister for the ports/ portion of the - tree. Mark Murray is the repomeister for the International - Crypto Repository in South Africa. + As a new committer there are a number of things you should do + first. + + + + Add yourself to the Developer's section of the + Handbook and remove yourself from the Additional + Contributors section. + + This is a relatively easy task, but remains a good first test of + your CVS skills. + - If you are a new committer, your very first commit should be - to add yourself to the developer's section (D.2) of the - Handbook and remove yourself from the Additional Contributors section - (19.6). Figuring out how to check the handbook out and add an - entry for yourself is relatively easy but still remains a good - first test of your CVS skills. If you can handle that one, - you are probably going to be ok. - - Your second commit should be to add an entry for yourself to - www/en/news/newsflash.sgml. Look for the other - entries that look like A new committer and follow the - format. - - Your next step should be to introduce yourself to the other - committers, otherwise no one will have any idea who you are or - what you are working on. You do not have to write a comprehensive - biography, just write a paragraph or two about who you are and - what you plan to be working on as a committer in FreeBSD. Email - this to cvs-committers@FreeBSD.org and you will be on - your way! - - Also, be sure to log into hub.FreeBSD.org - and create a - /var/forward/user - (where user is your username) file - containing the e-mail address where you want mail addressed - to yourusername@FreeBSD.org - to be forwarded. This includes all of the commit messages as - well as any other mail addressed to - cvs-committers@FreeBSD.org. Really large - mailboxes which have taken up permanent residence on - hub often get accidently - truncated without warning, so forward it or read it and you will - not lose it. + + Add an entry for yourself to + www/en/news/newsflash.sgml. Look for the other + entries that look like A new committer and follow the + format. + + + Some people also add an entry for themselves to + ports/astro/xearth/files/freebsd.committers.markers. + + + + Introduce yourself to the other committers, otherwise no one + will have any idea who you are or what you are working on. You do + not have to write a comprehensive biography, just write a paragraph + or two about who you are and what you plan to be working on as a + committer in FreeBSD. Email this to + cvs-committers@FreeBSD.org and you will be on your + way! + + + + Log into hub.FreeBSD.org and create a + /var/forward/user + (where user is your username) file + containing the e-mail address where you want mail addressed to + yourusername@FreeBSD.org to be forwarded. + This includes all of the commit messages as well as any other mail + addressed to cvs-committers@FreeBSD.org. Really + large mailboxes which have taken up permanent residence on + hub often get accidently truncated + without warning, so forward it or read it and you will not lose + it. + + + All new committers also have a mentor assigned to them for the first few months. Your mentor is more or less responsible for explaining anything which is confusing to you and is also diff --git a/en_US.ISO_8859-1/articles/committers-guide/article.sgml b/en_US.ISO_8859-1/articles/committers-guide/article.sgml index a6293c9c30..6899ce8dba 100644 --- a/en_US.ISO_8859-1/articles/committers-guide/article.sgml +++ b/en_US.ISO_8859-1/articles/committers-guide/article.sgml @@ -16,7 +16,7 @@ - $Date: 2000-07-13 21:07:52 $ + $Date: 2000-07-23 16:22:16 $ 1999 @@ -25,16 +25,10 @@ - Welcome, committer, to the FreeBSD development - team! - - The following docs are provided to orient you on doing CVS - operations on the FreeBSD central repository machine. A basic - familiarity with CVS is already assumed, although CVS - reference information, tutorials, and FAQs can also be found - at: http://www.cyclic.com/CVS/support - - Good luck, and welcome aboard! + This document provides information for the FreeBSD committer + community. All new committers should read this document before they + start, and existing committers are strongly encouraged to review it + from time to time. @@ -111,6 +105,24 @@ CVS Operations + It is assumed that you are already familiar with the basic operation + of CVS. + + The CVS Repository Meisters (Peter Wemm and John Polstra) + are the owners of the CVS repository and are + responsible for any and all direct + modification of it for the purposes of cleanup or fixing some + grievous abuse of CVS by a committer. No one else should + attempt to touch the repository directly. Should you cause some + repository accident, say a bad cvs import or tag operation, do + not attempt to fix it yourself! + Mail or call John or Peter immediately and report the problem to + one of them instead. The only ones allowed to directly fiddle + the repository bits are the repomeisters. Satoshi Asami is also a + repomeister for the ports/ portion of the + tree. Mark Murray is the repomeister for the International + Crypto Repository in South Africa. + CVS operations are usually done by logging into freefall, making sure the CVSROOT environment variable is set to @@ -144,61 +156,66 @@ done. The purpose of a repository copy is to preserve file change history, or logs. We in the FreeBSD Project greatly value the change history CVS gives to the project. + + CVS reference information, tutorials, and FAQs can also be found at: + http://www.cyclic.com/CVS/support + Conventions and Traditions - The CVS Repository Meisters (Peter Wemm and John Polstra) - are the owners of the CVS repository and are - responsible for any and all direct - modification of it for the purposes of cleanup or fixing some - grievous abuse of CVS by a committer. No one else should - attempt to touch the repository directly. Should you cause some - repository accident, say a bad cvs import or tag operation, do - not attempt to fix it yourself! - Mail or call John or Peter immediately and report the problem to - one of them instead. The only ones allowed to directly fiddle - the repository bits are the repomeisters. Satoshi Asami is also a - repomeister for the ports/ portion of the - tree. Mark Murray is the repomeister for the International - Crypto Repository in South Africa. + As a new committer there are a number of things you should do + first. + + + + Add yourself to the Developer's section of the + Handbook and remove yourself from the Additional + Contributors section. + + This is a relatively easy task, but remains a good first test of + your CVS skills. + - If you are a new committer, your very first commit should be - to add yourself to the developer's section (D.2) of the - Handbook and remove yourself from the Additional Contributors section - (19.6). Figuring out how to check the handbook out and add an - entry for yourself is relatively easy but still remains a good - first test of your CVS skills. If you can handle that one, - you are probably going to be ok. - - Your second commit should be to add an entry for yourself to - www/en/news/newsflash.sgml. Look for the other - entries that look like A new committer and follow the - format. - - Your next step should be to introduce yourself to the other - committers, otherwise no one will have any idea who you are or - what you are working on. You do not have to write a comprehensive - biography, just write a paragraph or two about who you are and - what you plan to be working on as a committer in FreeBSD. Email - this to cvs-committers@FreeBSD.org and you will be on - your way! - - Also, be sure to log into hub.FreeBSD.org - and create a - /var/forward/user - (where user is your username) file - containing the e-mail address where you want mail addressed - to yourusername@FreeBSD.org - to be forwarded. This includes all of the commit messages as - well as any other mail addressed to - cvs-committers@FreeBSD.org. Really large - mailboxes which have taken up permanent residence on - hub often get accidently - truncated without warning, so forward it or read it and you will - not lose it. + + Add an entry for yourself to + www/en/news/newsflash.sgml. Look for the other + entries that look like A new committer and follow the + format. + + + Some people also add an entry for themselves to + ports/astro/xearth/files/freebsd.committers.markers. + + + + Introduce yourself to the other committers, otherwise no one + will have any idea who you are or what you are working on. You do + not have to write a comprehensive biography, just write a paragraph + or two about who you are and what you plan to be working on as a + committer in FreeBSD. Email this to + cvs-committers@FreeBSD.org and you will be on your + way! + + + + Log into hub.FreeBSD.org and create a + /var/forward/user + (where user is your username) file + containing the e-mail address where you want mail addressed to + yourusername@FreeBSD.org to be forwarded. + This includes all of the commit messages as well as any other mail + addressed to cvs-committers@FreeBSD.org. Really + large mailboxes which have taken up permanent residence on + hub often get accidently truncated + without warning, so forward it or read it and you will not lose + it. + + + All new committers also have a mentor assigned to them for the first few months. Your mentor is more or less responsible for explaining anything which is confusing to you and is also -- cgit v1.3