Skip to content
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

DOC: Fix modules in index.rst Sphinx documentation index file #78

Merged
merged 1 commit into from
Oct 28, 2023

Conversation

jhlegarreta
Copy link
Contributor

@jhlegarreta jhlegarreta commented Oct 17, 2023

Fix Sphinx documentation:

  • Add a pre-build task to the readthedocs config file in order to
    generate the rst files from the package docstrings so that Sphinx
    build the HTML files from them.
  • Add the napoleon extension to the Sphinx config file so that it can
    parse NumPy and Google style docstrings.
  • Fix the index.rst file so that the package API is effectively
    displayed: set tractolearn as the entry for the reference section.
  • Set the scripts package as the entry for the scripts section in the
    index.rst file.

@github-actions github-actions bot added type:documentation Improvements or additions to documentation type:enhancement New feature or request labels Oct 17, 2023
@jhlegarreta jhlegarreta force-pushed the FixSphinxDocumentation branch from 7bac48e to cc560fd Compare October 17, 2023 17:06
@github-actions github-actions bot added type:enhancement New feature or request and removed type:enhancement New feature or request labels Oct 17, 2023
@jhlegarreta jhlegarreta marked this pull request as draft October 18, 2023 22:31
@jhlegarreta jhlegarreta force-pushed the FixSphinxDocumentation branch from cc560fd to f31eee2 Compare October 28, 2023 16:39
@github-actions github-actions bot added type:enhancement New feature or request and removed type:enhancement New feature or request labels Oct 28, 2023
Fix Sphinx documentation:
- Add a pre-build task to the `readthedocs` config file in order to
  generate the `rst` files from the package docstrings so that Sphinx
  build the HTML files from them.
- Add the `napoleon` extension to the Sphinx config file so that it can
  parse NumPy and Google style docstrings.
- Fix the `index.rst` file so that the package API is effectively
  displayed: set `tractolearn` as the entry for the reference section.
- Set the `scripts` package as the entry for the scripts section in the
  `index.rst` file.
@jhlegarreta jhlegarreta force-pushed the FixSphinxDocumentation branch from f31eee2 to 5607ea7 Compare October 28, 2023 16:58
@github-actions github-actions bot added type:enhancement New feature or request and removed type:enhancement New feature or request labels Oct 28, 2023
@jhlegarreta jhlegarreta marked this pull request as ready for review October 28, 2023 17:50
@jhlegarreta jhlegarreta changed the title ENH: Fix modules in index.rst Sphinx documentation index file DOC: Fix modules in index.rst Sphinx documentation index file Oct 28, 2023
@jhlegarreta jhlegarreta merged commit 1cc84fd into scil-vital:main Oct 28, 2023
9 checks passed
@jhlegarreta jhlegarreta deleted the FixSphinxDocumentation branch October 28, 2023 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type:documentation Improvements or additions to documentation type:enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant