Add references based on DOIs

[dalonsoa]

A more robust alternative will be to include the reference using just the DOI, for example:

@add_reference(short_purpose="Original implementation of R2T2", doi="10.5281/zenodo.1185316")
def my_great_function():
    pass

And then retrieve the complete data online (for example, using a tool like this). This approach requires internet connnection but this could be sorted out if the data is retrieved just once - possibly by the developer of the code - and then the reference information cached in a file shipped together with the code (see #10 and #11).

[rgaiacs]

I vote to add_reference have only two parameters: purpose and doi. And we fetch the data using doi2bib as suggested. I strong recommend that we cache the references but I suggest that we accept as universal true that the user has internet connection.

[dalonsoa]

Having internet connection is most likely the case, I fully agree. However, I don't see any reason to impose that requirement in the user (beyond the installation phase, of course) - specially if the information is going to be cached anyway.

In any case, purpose + doi is my preferred option, too 🙂