I'm fine with the note being in if you just clarify it a little, or taking it out (it's a bit of a non-sequitur right now).

I'm also +1 on defining a standard convention - perhaps one of you (either @cdeil or @kbarbary ) can broach the  subject on astropy-dev ?