These items could not be fully verified from the codebase alone. Do not invent answers — replace each placeholder when the project owner confirms the detail.
| Topic |
What should be documented |
Placeholder |
| Production API base URL |
Stable public host for customers |
Owner: confirm production LABELTY_API_URL |
| Marketing site vs API hosts |
How users discover the correct URL |
Owner: add link from app settings or this docs site |
| Plan names and quotas |
Endpoint caps, api_access tiers, notebook flags, prices |
Owner: sync with current pricing entitlements |
| Topic |
What should be documented |
Placeholder |
| Exact role matrix |
Which roles can create keys, train, deploy, run |
Owner: publish from RBAC source of truth |
| Key rotation UX |
How to revoke notebook-tagged keys and refresh space tags |
Owner: product behavior TBD |
| Topic |
What should be documented |
Placeholder |
| PyPI vs TestPyPI |
Which index is canonical for customers and notebooks |
Owner: lifecycle currently may use TestPyPI |
Published labelty_sdk.workflow import |
Exact install story for writing workflow.py outside the monorepo |
Owner: packaging status |
| Training / workflow client wrappers |
ETA or decision to wrap REST |
Owner: roadmap |
| Custom inference package layout |
Public copy of ML_CUSTOM_MODEL.md in Starlight |
Owner: migrate + screenshot |
| Topic |
What should be documented |
Placeholder |
| Resume-after-wallet-stop UX |
Button label + exact API body |
Owner: confirm against current UI |
| Supported trainer plugins beyond YOLO |
If/when other trainer_key values ship |
Owner: roadmap |
| Topic |
What should be documented |
Placeholder |
| SLA / rate limits |
Beyond process-local 429 |
Owner: product policy |
Security model for untrusted workflow.py |
Sandbox / egress rules for public exposure |
Owner: security review |
| Future outputs |
Webhooks, email, batch, streaming |
Owner: mark as roadmap only when planned |
| Topic |
What should be documented |
Placeholder |
| GPU image switching |
Whether GPU picker provisions a GPU image |
Owner: verify infra vs UI |
| EBS cost while stopped |
Customer-facing storage billing copy |
Owner: finance / infra |
| Collaboration rules |
Concurrent editors on one project space |
Owner: support policy |
Replace these placeholders in the guides when assets are ready:
Screenshot: Project → API Key → Create key
Screenshot: Training wizard dataset + compute steps
Screenshot: Training monitor live metrics
Screenshot: Create Workflow + activate
Screenshot: Project Notebook modal
Diagram: System architecture (label → train → build → workflow)
Diagram: Authentication flow (browser session vs project API key)
- Confirm the behavior in the running environment (not only design docs).
- Update the relevant Starlight page.
- Remove or shrink the matching row in this file.
