doc update
minor note updates