Comment by switchbak

Documenting it in a way that ensures it satisfies the example case would be preferred. You know, like with a test.