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

Fix docs errors and most warnings #9006

Merged
merged 14 commits into from
May 1, 2024
Merged

Conversation

erastorgueva-nv
Copy link
Collaborator

What does this PR do ?

Fix all current doc-building errors and most warnings. I have not fixed all warnings in the interest of making the PR not too large, and have tried to avoid making some changes that might conflict with @yaoyu-33 's current work on improving the doc structure.

FAO @titu1994 : please look over the changes to docs/source/conf.py. I removed the duplicate "sphinxcontrib.bibtex" extension. I have also commented out the "sphinx.ext.autosectionlabel" extension as that was causing a lot of "duplicate label" warnings.

Collection: Docs

Changelog

  • Add specific line by line info of high level changes in this PR.

Usage

  • You can potentially add a usage example below
# Add a code snippet demonstrating how to use this 

Jenkins CI

The Jenkins CI system has been replaced by GitHub Actions self-hosted runners.

There's no need to comment jenkins on the PR to trigger Jenkins CI.
The GitHub Actions CI will run automatically when the PR is opened.
To run CI on an untrusted fork, a NeMo user with write access must click "Approve and run".

Before your PR is "Ready for review"

Pre checks:

  • Make sure you read and followed Contributor guidelines
  • Did you write any new necessary tests?
  • Did you add or update any necessary documentation?
  • Does the PR affect components that are optional to install? (Ex: Numba, Pynini, Apex etc)
    • Reviewer: Does the PR have correct import guards for all optional libraries?

PR Type:

  • New Feature
  • Bugfix
  • Documentation

If you haven't finished some of the above items you can still open "Draft" PR.

Who can review?

Anyone in the community is free to review the PR once the checks have passed.
Contributor guidelines contains specific people who can review PRs to various areas.

Additional Information

  • Related to # (issue)

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
erastorgueva-nv and others added 11 commits April 22, 2024 17:00
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: yaoyu-33 <yaoyu.094@gmail.com>
@ericharper ericharper merged commit 8c1ce65 into main May 1, 2024
129 checks passed
@ericharper ericharper deleted the erastorgueva/docs-warnings branch May 1, 2024 22:52
suiyoubi pushed a commit that referenced this pull request May 2, 2024
* add various docs fixes

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* make conf.py changes clearer

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* fix Duplicate explicit target name error for links

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* more fixes, mainly citations

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* fix some code formatting

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* update hf space iframe link

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* fix new ERRORs

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* Update docs

Signed-off-by: yaoyu-33 <yaoyu.094@gmail.com>

---------

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: yaoyu-33 <yaoyu.094@gmail.com>
Co-authored-by: yaoyu-33 <yaoyu.094@gmail.com>
Co-authored-by: Eric Harper <complex451@gmail.com>
Signed-off-by: Ao Tang <aot@nvidia.com>
rohitrango pushed a commit to rohitrango/NeMo that referenced this pull request Jun 25, 2024
* add various docs fixes

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* make conf.py changes clearer

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* fix Duplicate explicit target name error for links

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* more fixes, mainly citations

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* fix some code formatting

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* update hf space iframe link

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* fix new ERRORs

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>

* Update docs

Signed-off-by: yaoyu-33 <yaoyu.094@gmail.com>

---------

Signed-off-by: Elena Rastorgueva <erastorgueva@nvidia.com>
Signed-off-by: yaoyu-33 <yaoyu.094@gmail.com>
Co-authored-by: yaoyu-33 <yaoyu.094@gmail.com>
Co-authored-by: Eric Harper <complex451@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants