massive update to documentation