Documentation matching the preceding changes

Who doesn't need moar doc ?