Add some comments about entries formats.

Group by mentor, sort alphabetically, move adamw to alumni.

3 files changed, 56 insertions, 7 deletions

diff --git a/share/misc/committers-doc.dot b/share/misc/committers-doc.dot
index 41d2cc8..55ccad1 100644
--- a/share/misc/committers-doc.dot
+++ b/share/misc/committers-doc.dot
@@ -2,27 +2,42 @@
 
 digraph doc {
 
+# Node definitions follow this example:
+#
+#   foo [label="Foo Bar\nfoo@FreeBSD.org\n????/??/??"]
+#
+# ????/??/?? is the date when the commit bit was obtained, usually the one you
+# can find looking at CVS logs for the access (or avail) file under CVSROOT.
+#
+# For returned commit bits, the node definition will follow this example:
+#
+#   foo [label="Foo Bar\nfoo@FreeBSD.org\n????/??/??\n????/??/??"]
+#
+# The first date is the same as for an active committer, the second date is
+# the date when the commit bit has been returned. Again, check CVS logs.
+
 node [color=grey62, style=filled, bgcolor=black];
 
-# Alumni go here.
+# Alumni go here. Try to keep things sorted.
 
 node [color=lightblue2, style=filled, bgcolor=black];
 
 # Current doc committers go here. Try to keep things sorted.
 
 bvs [label="Vitaly Bogdanov\nbvs@FreeBSD.org\n2005/10/03"]
-cperciva [label="Colin Percival\ncperciva@FreeBSD.org\n2004/01/20"]
 den [label="Denis Peplin\nden@FreeBSD.org\n2003/09/13"]
 gabor [label="Gabor Kovesdan\ngabor@FreeBSD.org\n2007/02/02"]
 keramida [label="Giorgos Keramidas\nkeramida@FreeBSD.org\n2001/10/12"]
 marck [label="Dmitry Morozovsky\nmarck@FreeBSD.org\n2004/08/10"]
 
 # Here are the mentor/mentee relationships.
+# Group together all the mentees for a particular mentor.
+# Keep the list sorted by mentor login.
+
+den -> marck
 
 keramida -> gabor
 
 marck -> bvs
 
-den -> marck
-
 }
diff --git a/share/misc/committers-ports.dot b/share/misc/committers-ports.dot
index c9f2537..edbf1be 100644
--- a/share/misc/committers-ports.dot
+++ b/share/misc/committers-ports.dot
@@ -2,15 +2,30 @@
 
 digraph ports {
 
+# Node definitions follow this example:
+#
+#   foo [label="Foo Bar\nfoo@FreeBSD.org\n????/??/??"]
+#
+# ????/??/?? is the date when the commit bit was obtained, usually the one you
+# can find looking at CVS logs for the access (or avail) file under CVSROOT.
+#
+# For returned commit bits, the node definition will follow this example:
+#
+#   foo [label="Foo Bar\nfoo@FreeBSD.org\n????/??/??\n????/??/??"]
+#
+# The first date is the same as for an active committer, the second date is
+# the date when the commit bit has been returned. Again, check CVS logs.
+
 node [color=grey62, style=filled, bgcolor=black];
 
-# Alumni go here.
+# Alumni go here.. Try to keep things sorted.
+
+adamw [label="Adam Weinberger\nadamw@FreeBSD.org\n2002/10/16\n2006/09/25"]
 
 node [color=lightblue2, style=filled, bgcolor=black];
 
 # Current ports committers go here. Try to keep things sorted.
 
-adamw [label="Adam Weinberger\nadamw@FreeBSD.org\n2002/10/16\n2006/09/25"]
 ahze [label="Michael Johnson\nahze@FreeBSD.org\n2004/10/29"]
 erwin [label="Erwin Lansing\nerwin@FreeBSD.org\n2003/06/04"]
 flz [label="Florent Thoumie\nflz@FreeBSD.org\n2005/03/01"]
@@ -28,6 +43,8 @@ shaun [label="Shaun Amott\nshaun@FreeBSD.org\n2006/06/19"]
 tmclaugh [label="Tom McLaughlin\ntmclaugh@FreeBSD.org\n2005/09/15"]
 
 # Here are the mentor/mentee relationships.
+# Group together all the mentees for a particular mentor.
+# Keep the list sorted by mentor login.
 
 adamw -> ahze
 adamw -> jylefort
diff --git a/share/misc/committers-src.dot b/share/misc/committers-src.dot
index d375385..4656012 100644
--- a/share/misc/committers-src.dot
+++ b/share/misc/committers-src.dot
@@ -2,9 +2,23 @@
 
 digraph src {
 
+# Node definitions follow this example:
+#
+#   foo [label="Foo Bar\nfoo@FreeBSD.org\n????/??/??"]
+#
+# ????/??/?? is the date when the commit bit was obtained, usually the one you
+# can find looking at CVS logs for the access (or avail) file under CVSROOT.
+#
+# For returned commit bits, the node definition will follow this example:
+#
+#   foo [label="Foo Bar\nfoo@FreeBSD.org\n????/??/??\n????/??/??"]
+#
+# The first date is the same as for an active committer, the second date is
+# the date when the commit bit has been returned. Again, check CVS logs.
+
 node [color=grey62, style=filled, bgcolor=black];
 
-# Alumni go here.
+# Alumni go here.. Try to keep things sorted.
 
 node [color=lightblue2, style=filled, bgcolor=black];
 
@@ -15,8 +29,11 @@ dds [label="Diomidis Spinellis\ndds@FreeBSD.org\n2003/06/20"]
 flz [label="Florent Thoumie\nflz@FreeBSD.org\n2006/03/30"]
 
 # Here are the mentor/mentee relationships.
+# Group together all the mentees for a particular mentor.
+# Keep the list sorted by mentor login.
 
 cperciva -> flz
+
 schweikh -> dds
 
 }