Added comments and compiler warning notes to docs