KhronosGroup / KhronosGroup/OpenCL-Docs

Move Normative Text Out of Appendices

Open
#1,480 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

See: https://github.com/KhronosGroup/OpenCL-Docs/issues/1467#issuecomment-3417603695

We should:

1. Clearly document which appendices are normative and which are informative. Are all appendices informative?
2. Move the normative text from Appendix C out of the appendix and into the main spec.

Contributor guide

Open the contributing guide

Research direction

Start with the discussion linked from issue 1467, especially the referenced comment, and review the appendices to determine which are normative or informative. Identify the normative material in Appendix C and the appropriate locations in the main specification; done means the appendix status is documented and that material no longer remains in Appendix C.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.