massive additions to documentation