WIP: doc changes
Fixes
Merge pull request #6 from pmorie/dev/upgrade_analysis

Dev/upgrade analysis