Add a reference using a key from a BibTeX file

[jezcope]

References could be added using a bibtex key, rather than the full reference, and then, when required, retrieve the reference information from a .bib file:

@add_reference(short_purpose="Original implementation of R2T2", key="Alonso2018-1")
def my_great_function():
    pass

This bibtex file should be shipped together with the code, not as part of the documentation. It could double the file use for chache data described in #9 .

[rgaiacs]

I'm against using BibTeX key because it hide changes in the reference to the user.

[dalonsoa]

Bibtex is widely used when creating the documentation (Sphinx, Doxygen), so using that will ease the adoption of the tool, I think. Besides, there are things - hopefully not that many - that do not have a DOI, specially old books. How do you reference those?

[ChasNelson1990]

I'll be looking at this this morning.