finalized documentation, completes #3706