ByteDance-Seed / ByteDance-Seed/Triton-distributed
LittleKernel Scalar Types table is missing from rendered docs
- Dominant language
- Python
- Stars
- 1.5k
- Forks
- 172
- PR merge metrics
- No merged PRs in 30d
Description
### Description
The Scalar Types table in `docs/little_kernel/dsl-reference.rst` is malformed because values in the C++ Type column exceed the table's declared width. Sphinx drops the table content, leaving only the `Scalar Types` heading in the rendered documentation.
This is visible on the current live page: https://triton-distributed.readthedocs.io/en/latest/little_kernel/dsl-reference.html
### Reproduction
At main commit `8260bc34398c2b8f36dc840fd22f741ca9294584`:
```console
$ sphinx-build -E -a -n -W --keep-going -b html docs _build/html
docs/little_kernel/dsl-reference.rst:43: ERROR: Malformed table.
Right border not aligned or missing.
```
The same build renders no `` element on the DSL Reference page.
### Expected behavior
The documented LittleKernel scalar types, C++ mappings, and byte widths should render as a table, and the table should not produce a Sphinx error.
Contributor guide
Research direction
Open docs/little_kernel/dsl-reference.rst and inspect the Scalar Types table around line 43, starting with the Sphinx error shown in the issue. Adjust the table so the documented scalar types, C++ mappings, and byte widths render correctly, then run sphinx-build -E -a -n -W --keep-going -b html docs _build/html and verify the DSL Reference page contains the table without errors.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cpp
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 88/100