Skip to content

Surface known limitations more prominently in compiler docs #1033

@Keinberger

Description

@Keinberger

The compiler index page already mentions that known bugs and limitations exist and links to the issue tracker, which is good. However, the detailed known-limitations doc (docs/external/src/appendix/known-limitations.md) that actually lists specific limitations is marked draft: true, so it doesn't render in the published docs. The appendix index linking to it is also marked draft: true.

This means the detailed information exists but isn't reachable. Pioneer developers are discovering these limitations during development rather than upfront.

I think we should remove the draft: true flags and make sure the index page links to the full known-limitations page directly, not just to the issue tracker.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions