Add some comments about entries formats.

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

1 files changed, 19 insertions, 4 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
-
 }