Jira reference roles

Documenteer provides reStructuredText roles to simplify linking to issues in LSST’s Jira ticketing system at https://rubinobs.atlassian.net.

To use these roles, add the documenteer.ext.jira extension to your conf.py file:

extensions = ["documenteer.ext.jira"]

Roles

:jira:

Link to a Jira issue using the issue ID as an argument. Example:

:jira:`DM-22957`

Output: DM-22957

:jirap:

Link to a Jira issue using the issue ID as an argument, with the link enclosed in parentheses. Example:

:jirap:`DM-22957`

Output: (DM-22957)

:jirab:

Link to a Jira issue using the issue ID as an argument, with the link enclosed in square brackets. Example:

:jirab:`DM-22957`

Output: [DM-22957]