big updates to documentation section.