Related: http://stackoverflow.com/questions/8820276/docstring-for-variable

So it seems like you can reference the variable from the module docstring using directives like `:py:var:` and `:py:ivar:` or you can use `variable.__doc__`. I would vote for just describing it in the module docstring.