-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
priority:normalNormal scheduling priorityNormal scheduling prioritystatus:readyReady to startReady to starttype:docsDocumentation additions or correctionsDocumentation additions or corrections
Milestone
Description
Summary
Design a clearer user-facing catalog/table experience for design-research-problems, potentially with separate entrypoints for catalog browsing versus API/reference usage.
Why
This repo is the main outlier in the module family: users often want to browse what problems exist before they care about the Python API details. Right now that catalog story is not prominent enough in the docs.
Questions to resolve
- Should the docs have separate high-level entrypoints for:
- browsing the problem catalog
- learning the library / API surface
- Should the catalog be presented as a generated table, matrix, or searchable summary page across families?
- What metadata should be visible at a glance for each problem family or packaged problem?
- family
- compute requirements
- optional dependencies
- interfaces / entrypoints
- canonical examples
Proposed work
- Add a user-facing catalog landing page or section that is clearly different from the API reference.
- Provide a concise table or matrix that helps users compare problem families and find the right entrypoint quickly.
- Evaluate whether the docs should split into separate entrypoints such as “Catalog” and “Reference/API”.
- Make sure the final information architecture still works cleanly inside the shared PyData-based docs shell.
Acceptance criteria
- There is a documented information architecture decision for catalog browsing versus API/reference browsing.
- The docs expose a clear user-facing catalog/table for the packaged problem space.
- A new user can answer “what problems are available and how do I start?” without reading the full API reference.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
priority:normalNormal scheduling priorityNormal scheduling prioritystatus:readyReady to startReady to starttype:docsDocumentation additions or correctionsDocumentation additions or corrections