KhronosGroup / KhronosGroup/OpenCL-Docs

increase usage of asciidoctor dictionaries in extensions spec

Open
#825 1 comment 0 reactions 1 assignee View on GitHub

@bashbaug is already working on this.

Since Nov 29, 2022.

OpenCL Extension Spec
Dominant language
Python
Stars
421
Forks
132
Avg merge
5d 13h
Merged PRs (30d)
11

Description

We moved the OpenCL API spec to use asciidoctor dictionaries for API names, type names, and enum names several years ago, but we haven't made similar upgrades to the extension spec. Switching to the asciidoctor dictionaries will provide a similar look-and-feel across all extensions and will also provide a useful check that all of the symbols added by an extension are properly spelled and that we haven't omitted any symbols from the XML file.

I'll probably do these conversions one at a time to provide for easier review and so we can potentially parallelize the work. We can use this issue to track progress and what is remaining.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.