Add doc dir to .gitignore
Use monkey patch to prevent warnings when generating docs for example project with rake
Improve documentation of Declaration classes