Detailed notation on buildamodule modules

Hiya,

If you're like me, you need to make notes of EVERYTHING in a program when you're getting used to a new syntax. I'm currently writing heavy amounts of notation in the buildamodule trails.module file. For example (the JE indicates that I added the note, I tend to write CS for Chris' notation):

// JE: Add the page the user is currently at to the trail.
// if array doesn't exist yet, [] = add this array to it.
// if array DOES exist, [] = don't wrap this array in a multidimensional array (as you might if you put
// a key in the square brackets
$trail[] = array(

// JE: the title
'title' => strip_tags(drupal_get_title()),
// get the path of the current page using good-old $_GET
'path' => $_GET['q'],
// drupal's succinct way of calling the time function
'timestamp' => REQUEST_TIME,
);

when i'm finished notating, if anyone else thinks it might help their learning, would you like me to ask chris if i can post up what i've done?