As a maintainer, I'd personally prefer this kinda stuff be explained in an inline comment, what do you think?