ByteDance-Seed / ByteDance-Seed/Triton-distributed

LittleKernel Scalar Types table is missing from rendered docs

Open Beginner friendly
#188 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.