Dear Matthias,

thanks for your message.

Am 26.09.2018 18:19 schrieb Matthias Geier:
But I think it makes sense to manually select which modules you want
to be scanned for your documentation. You might have some internal
modules which you don't want to appear in the docs, for example.

You describe here two different scenarios: Opt-In and Opt-Out. Both of them make sense for some users and/or some projects. But it should be up to the user to decide to use an Opt-In or Opt-Out mechanism.

Opt-In makes absolutly no sense to me, because this is againts the "automatic" thing I would expect.

The current default behavoir of Sphinx makes no sense because the result is empty. Also a complex software like Sphinx should work out of the box, what means producing some docu in a default way.

But the idea is that mentioning the module should be enough, as you did:

.. automodule:: feedybus
    :members:

I will try this.

--
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to