-
Notifications
You must be signed in to change notification settings - Fork 2
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
MkDocs documentation in template omits submodules #365
Labels
bug
Something isn't working
Comments
matt-graham
added a commit
that referenced
this issue
Jun 4, 2024
Fixes #365 Enables `plugins.mkdocstrings.handlers.python.options.show_submodules` option in `mkdocs.yml` configuration file for template so that [submodules of the top-level package are included in autogenerated API reference documentation by default.](https://stackoverflow.com/a/74237199)
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Describe the Bug
MkDocs documentation in template doesn't include submodules of top-level package in API reference as we don't enable the
show_submodules
option.To Reproduce
Create an instance of template, add a submodule to the package with a docstring, generate docs.
Expected Behaviour
Documentation generated for top-level package and all submodules.
Actual Behaviour
Only the definitions in top-level
__init__.py
file appear in API reference page.Additional Context
The text was updated successfully, but these errors were encountered: