improved documentation
excludes NOTES from being published