Document the new paragraph method. [ci skip]