-
Notifications
You must be signed in to change notification settings - Fork 6k
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
[Docs] Fix Data examples TOC and rendering #36404
Conversation
Signed-off-by: amogkam <amogkamsetty@yahoo.com>
doc/source/_toc.yml
Outdated
@@ -96,7 +96,7 @@ parts: | |||
- file: data/getting-started | |||
- file: data/key-concepts | |||
- file: data/user-guide | |||
- file: data/examples | |||
- file: data/data_examples |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- file: data/data_examples | |
- file: data/data_examples | |
title: Examples |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Are you open to keeping the name the same?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The name isn't changed in this PR. It's still being pulled from the title of data_examples.rst
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think you can set it with that title
line, no?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If not provided, it will default to the title in the rst file
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks! this is obviously much better.
.. toctree:: | ||
:hidden: | ||
|
||
huggingface_vit_batch_prediction | ||
pytorch_resnet_batch_prediction | ||
batch_inference_object_detection | ||
nyc_taxi_basic_processing | ||
batch_training | ||
ocr_example | ||
random-access | ||
custom-datasource |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These will show up in the navbar.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
yep, as you mentioned offline, doesn't seem there's an easy way to avoid this
b10f19d renamed the examples file for Ray Data. We have to make the corresponding change to the TOC, so that the page still shows up on the docs. Also removes the example files from exclude_patterns so they are built correctly. Includes the examples in a hidden toctree to prevent sphinx warnings. --------- Signed-off-by: amogkam <amogkamsetty@yahoo.com> Signed-off-by: e428265 <arvind.chandramouli@lmco.com>
b10f19d renamed the examples file for Ray Data.
We have to make the corresponding change to the TOC, so that the page still shows up on the docs.
Also removes the example files from
exclude_patterns
so they are built correctly.Includes the examples in a hidden toctree to prevent sphinx warnings.
Why are these changes needed?
Related issue number
Checks
git commit -s
) in this PR.scripts/format.sh
to lint the changes in this PR.method in Tune, I've added it in
doc/source/tune/api/
under thecorresponding
.rst
file.