[nine_k]

I'd boil it down to two statements.

* Avoid magic, be idiomatic.

* If you create something even slightly non-trivial, explain it in documentation.