claimed-framework / claimed-framework/mlx_deprecated

Usability issues with Datasets and Notebooks

Open
#152 2 comments 0 reactions 1 assignee Claimed by @ckadner View on GitHub
documentation
Dominant language
Python
Stars
220
Forks
54
PR merge metrics
No merged PRs in 30d

Description

**Describe the bug**

It is not clear how to run notebooks and datasets? There should be a succinct documentation of ...
- How are notebooks and datasets related?
- From a data users can navigate to a notebook, but not vice versa?!
- Need to describe why running a dataset asks for a namespace (-> PVC creation)
- What happens after a Dataset has been "launched"?
- Running a dataset with related asset (notebook) asks for PVC? How does a user get that?
- What should the Mount Path be? (-> `/tmp/data` ... MLX UI should prefill)
- Why does the pipeline run show no inputs and outputs?
- What are the results of a Notebook run, where can they be found (Minio > HTML, original notebook updated, preview in MLX UI Notebook card -- unless cached?)
- Download Notebook, after run, should contain updated notebook and/or HTML of last run
- Add a Troubleshooting section, i.e. for `403` error while trying to create PVC when missing permissions to create CRDs

We should update the doc here:
https://github.com/machine-learning-exchange/mlx/blob/main/datasets/README.md#use-dataset-with-mlx-assets

Thanks @blublinsky for reporting

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.