documenting some code