Every "we should document that" is a bug until proven otherwise.