come up with a good framework for citing stuff in docstrings

[malb]

the framework should allow to generate a bibliography etc. while not reinventing the wheel: BibTeX? By citing in docstrings I mean stuff like this:

INPUT:
   foo -- bar (as described in [BCDT]

REFERENCES:
[BCDT] Breuil, Conrad, Diamond, Taylor, "Modularity ...."

Component: documentation

Issue created by migration from https://trac.sagemath.org/ticket/3911

[malb]

comment:1

This is fixed thanks to Sphinx and ReST which has native support for this.

[sagetrac-mabshoff]

comment:2

Well, it should be documented in some way how we do things things. If such documentation exists a link from the ticket would be nice.

Cheers,

Michael

[malb]

comment:3

It is a standard feature of ReST, see: http://sphinx.pocoo.org/rest.html#citations

[sagetrac-mabshoff]

comment:4

Replying to @malb:

It is a standard feature of ReST, see: http://sphinx.pocoo.org/rest.html#citations

I now that. I meant in Sage's documentation so that documentation writes in Sage will use it :).

Cheers,

Michael