improve code-comments some more