encourage sane coding practices in the documentation