Personally I don't like C++ comments (//). I tend to use (* *) for important stuff and { } to explain code inside the methods, functions and procedures.
I recommend you to read about
pasdoc. It
forces you to document everything in a way that in my opinion is very human-friendly. Take a look to my
Allegro.pas code to see it
in action.
I like you have explained stuff inside the code. Not a lot of people do that and it helps a lot. Note that when we are writing code it always looks clear and even obvious, but in most cases it isn't! Explaining it a bit helps to understand it, even to yourself when you're updating it some weeks/months later.