> Yes, exactly. What else?

There is nothing in either the name or API dox implying any particular completeness of said document, or hinting it would pass validation. Each developer will take different things for granted depending on their approach and experiences. Concepts are tricky to describe succinctly, and many times things are more subjective than we like to admit.

Back to the technical details, the method is only 12 lines long, and is almost identical to your code below.