KhronosGroup / KhronosGroup/OpenCL-Docs

Generate extensions document automatically

Open
#848 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
420
Forks
131
Avg merge
5d 13h
Merged PRs (30d)
11

Description

- [ ] Generate list of extensions from XML
- [ ] Define rules to guarantee uniqueness of anchors and document them in the extension template or extension README
- [ ] Decide what to do with extensions still authored in plaintext and extensions present in the XML but for which there is no specification (yet)

See https://github.com/KhronosGroup/OpenCL-Docs/pull/846 for background and discussions.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing pull request #846 and the repository's XML sources, extension template, and extension README. Resolve the listed questions about generated extension lists, unique anchors, plaintext extensions, and undocumented XML extensions; done means the generation approach and documentation rules are defined for each case.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
build-system, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.