updated documentation with extensibility information