ray/doc/source/data/api
matthewdeng 9a0c1f5e0a
[data] update datasets API structure (#27592)
Refactor Datasets API docs for easier navigation: [Ray Datasets API](https://ray--27592.org.readthedocs.build/en/27592/data/api/api.html)

### Changes

1. Create a new Datasets API base page.
2. Split existing APIs into separate pages.
3. Split `Dataset` and `DatasetPipeline` methods into separate sections.
     1. Used `autosummary` to generate overview tables at the top of each of these pages. Open to other suggestions e.g. moving the summary to the top of each section instead.
     2. **Note:** Every time we add a new method we need to explicitly add it here as well.
4. Add Input/Output APIs.
     1. I chose to split these primarily by data format rather than type, since it's easier to navigate, and the existing [Creating Datasets](https://docs.ray.io/en/master/data/creating-datasets.html) User Guide already does the latter.
6. Add `Block` and `DataBatch` (should we add these aliases?)
7. Remove existing `package-ref`.
2022-08-11 23:10:10 -07:00
..
api.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
data_representations.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
dataset.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
dataset_context.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
dataset_pipeline.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
grouped_dataset.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
input_output.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
random_access_dataset.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00
utility.rst [data] update datasets API structure (#27592) 2022-08-11 23:10:10 -07:00