moar doc updates and added description