Order of methods docstrings inside function block when using Documenter

Hi everyone!

I’m having trouble with order of appearance of methods docstrings inside a function block using Documenter.jl macro @docs. This order seems to be random. That is everytime I build the docs the order of methods docstrings inside a function can vary and it does vary in many functions.
For example docs for this function from base/collections:

```@docs
Base.pairs
```

can be built in different order:

Base.pairs(::Any)
Base.pairs(::IndexLinear, ::AbstractArray)

or

Base.pairs(::IndexLinear, ::AbstractArray)
Base.pairs(::Any)

Is it possible to freeze the order of docstrings inside these functions with multiple docstrings?
The problem is that I’m having a lot of parasitic text differences because of it while trying to build the docs after some updates for my project. I’m making the localization of Base Julia docs.

1 Like