# Required Documenteer 0.4.3 upgrade for Sphinx technotes + BibTeX bibliography usage

**URL:** <https://www.rubin.community/t/required-documenteer-0-4-3-upgrade-for-sphinx-technotes-bibtex-bibliography-usage/3453>\
**Category:** DM Notifications\
**Tags:** doc-engineering\
**Created:** [November 30, 2018, 10:41pm UTC](https://www.rubin.community/t/required-documenteer-0-4-3-upgrade-for-sphinx-technotes-bibtex-bibliography-usage/3453 "2018-11-30T22:41:59Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![jsick](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/jsick/32/672_2.png) [@jsick](https://www.rubin.community/u/jsick)\
**Post date:** [November 30, 2018, 10:41pm UTC](https://www.rubin.community/t/required-documenteer-0-4-3-upgrade-for-sphinx-technotes-bibtex-bibliography-usage/3453/1 "2018-11-30T22:41:59Z")

</div>

This message is for authors of Sphinx (reStructuredText) technotes. First, there is a required update to the `requirements.txt` file. Second, if you use the `bibliography` directive, there is an updated usage pattern. Read on for details.

## 1. Update documenteer

You need to upgrade the version of [Documenteer](https://documenteer.lsst.io) that builds your technote.

In the `requirements.txt` file in the technote’s Git repository, set the `documenteer` dependency to:

```auto
documenteer[technote]>=0.4.3,<0.5.0

```

This new version of Documenteer will ensure that [sphinxcontrib-bibtex](https://sphinxcontrib-bibtex.readthedocs.io/en/latest/index.html) is compatible with the pinned version of [Sphinx](http://www.sphinx-doc.org/en/master/).

## 2. Updated usage of the bibliography directive

In the past, we recommended that you have an `encoding` field in the `bibliography` directive. With recent changes to [sphinxcontrib-bibtex](https://sphinxcontrib-bibtex.readthedocs.io/en/latest/index.html) this is no longer the case — you actually can’t use the `latex+latin` encoding at all!

The [new usage](https://developer.lsst.io/project-docs/technotes.html#using-bibliographies-in-restructuredtext-technotes) is:

```auto
.. bibliography:: local.bib lsstbib/books.bib lsstbib/lsst.bib lsstbib/lsst-dm.bib lsstbib/refs.bib lsstbib/refs_ads.bib
   :style: lsst_aa

```