finalized documentation, completes #3076