DOC: references aren't dumb
Merge pull request #498 from ebolyen/doc_references

DOC: references aren't dumb