How to automatically include all docstrings from a module? about documenter.jl HOT 4 CLOSED

Yes, I've thought of adding a {autodocs} code block,

    {autodocs}
    Foo
    Bar

which would do this (Foo and Bar are modules). It's not been implemented yet since I've not decided how the sorting and filtering of docs should behave. Input on that kind of thing would be valuable if you have any.

from documenter.jl.

yes, that would be great. I would sort as follows:

1. Module level docs
2. Exported Types
3. Exported Constants
4. Exported Methods

And the order for each will be the order specified in the export list.

from documenter.jl.

And the order for each will be the order specified in the export list.

The actual order in which bindings are exported from a module doesn't get tracked as far as I recall, so it's probably not possible to do that without reparsing source files. names(MyMod) returns exports sorted in alphabetical order, so that might be the best we can do. Other than that your ordering sounds good to me 👍.

from documenter.jl.

An basic {autodocs} has been added in 268162c, which can be adjusted in future if need be. For now I'll close this.

from documenter.jl.