comments and fine tuning

just a little tweaking to the result strings and some notes for further
use