feature: `members_order = '__all__'`

[samuelcolvin]

Would be great if we could add another option to members_order to respect the order of __all__.

I think mkdocstrings already respects __all__ to include members, so I guess it shouldn't be that hard to add?

[pawamoy]

We're actually very close to supporting __all__ (a few internals to refactor to officialize it) 🙂

Then yes, supporting __all__ ordering should be easy. Quick question: what happens for classes? They don't define __all__. I suppose members_order could accept a list?

members_order:
- __all__
- source

There might be more elegant ways to specify that 🤔

[samuelcolvin]

List sounds fine to me.

[pawamoy]

Released with https://mkdocstrings.github.io/python/insiders/changelog/#1.12.0