# ANN: Documenter 1.0

**URL:** <https://discourse.julialang.org/t/ann-documenter-1-0/103888>\
**Category:** Package Announcements\
**Tags:** package, announcement, documenter\
**Created:** [September 15, 2023, 11:10am UTC](https://discourse.julialang.org/t/ann-documenter-1-0/103888 "2023-09-15T11:10:46Z")\
**Posts on this page:** 1\
**Showing post:** 6

<div class="post-metadata">

**Author:** ![goerz](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/goerz/32/3269_2.png) [@goerz](https://discourse.julialang.org/u/goerz)\
**Post date:** [September 16, 2023, 6:08am UTC](https://discourse.julialang.org/t/ann-documenter-1-0/103888/6 "2023-09-16T06:08:47Z")

</div>

For anyone who is using the [DocumenterCitations plugin](https://github.com/JuliaDocs/DocumenterCitations.jl) to add bibliographic references to their documentation: We also just released DocumenterCitations 1.2.0 to be compatible with Documenter 1.0.

A notable breaking change in Documenter 1.0 that affects any users of DocumenterCitations is that plugin objects now have to be passed to `makedocs` via a `plugins` keyword argument. For the old Documenter 0.27 / DocumenterCitations 1.1 your `docs/make.jl` file would have looked like this:

```julia
using DocumenterCitations

bib = CitationBibliography(
    joinpath(@ __DIR__ , "src", "refs.bib");
    style=:numeric
)
makedocs(bib, ...) # positional argument

```

With the new Documenter 1.0 / DocumenterCitations 1.2 you will have to change this to

```julia
makedocs(; plugins=[bib], ...)

```

Apart from compatibility with Documenter 1.0, changes since the [original announcement](https://discourse.julialang.org/t/ann-documentercitations-v1-0-0/101562) include a significantly improved [`:alpha` citation style](https://juliadocs.org/DocumenterCitations.jl/v1.2/gallery/#alphabetic_style) that avoids duplicate labels and [better support for preprint servers](https://juliadocs.org/DocumenterCitations.jl/v1.2/syntax/#Preprint-support) like arXiv. See [`NEWS.md`](https://github.com/JuliaDocs/DocumenterCitations.jl/blob/master/NEWS.md) for more details.

---

_[View the full topic](https://discourse.julialang.org/t/ann-documenter-1-0/103888)._