Comments cleanup and cleaned up one failed test:

 - added more comments/updated existing;
 - removed superfluous/obsolete comments.