> Documenting is hard... 

Couldn't agree more. Your version is defintely clearer, updating it.