Documentation upates - clarifications and more comments.