NVIDIA-Merlin / NVIDIA-Merlin/Merlin
[RMP] Centralize Documentation into the Merlin/Merlin repo
Open
@nv-alaiacano is already working on this.
Since Jun 27, 2023.
examples
roadmap
- Dominant language
- Python
- Stars
- 907
- Forks
- 129
- PR merge metrics
- No merged PRs in 30d
Description
Problem:
The feedback of our repository is that it is easy to follow:
- Every repository has its own documentations. Users have to switch back and forth between documentations
- There is no single entry point for users where to start and read something end-to-end
Some examples:
- TensorFlow: https://www.tensorflow.org/tutorials ; https://www.tensorflow.org/guide
- Ray https://docs.ray.io/en/latest/
Goal:
Provide a better user experience for our documentations
High Level Decision:
We need to decide:
- How should (new) users discover Merlin?
- Do we have one centralized documentation vs. documentations per repository?
-
-
- If centralised - what does it mean? Do we move all API docstring documentation into one repository?
-
Some Options:
- Move the docs to a single main Merlin Repo
- Rewrite Introduction Page: https://docs.google.com/document/d/1jp6wGZb6x9qVXR5axy0_SSeZ1nI3vLcfpvGH_A0vc-w/edit
- Add additional pages for Recommender System Guide: https://nvidia-merlin.github.io/Merlin/main/guide/recommender_system_guide.html
-
- Recommender Systems - Systems - Deployment/Multi-Stage
-
- Advanced Topics - Multi-Task Learning, Pre-Trained Embeddings, Negative Sampling, etc.
-
- Scaling - Data Parallel Training / Model Parallel Training ; Distributed Embeddings
- Installation Guide: https://github.com/NVIDIA-Merlin/Merlin/pull/811
- Docstring coverage (and reviewing if docstrings are correct?)
- Integrating the examples into Documentation
- Move examples that are split across repos (Systems, Models) into Merlin repo
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.