- docs update to reflect latest refactorings