removing a warning.
sectioning the document
refactoring for auto-update.
adding comments.