multiple documentation section improvements