Implementation details: no unnecessary or confusing assumptions allowed

API specification should be checked that it does not make unnecessary or confusing assumptions about implementations. For example, the very last sentence of EGL section “Releasing Thread State,” which is section 3.12 in EGL version 1.5 specification, indicates that calling ‘eglGetError’ immediately following a successful call to ‘eglReleaseThread’ “will also result in reallocating per-thread state.” In this case, it is not certain whether verb “will” stands for “should” or whether it indicates an assumption about implementations.

For reference, general issue "Implementation details" is defined as issue no. 32 in the "KSCAF_DocGuidelines" project.

Start with the general “Implementation details” issue referenced as issue 32 in the KSCAF_DocGuidelines project, then review this requirement against the EGL 1.5 “Releasing Thread State” section 3.12 example. Done means the requirement clearly distinguishes normative guidance from assumptions about implementations and addresses the cited wording.

Written by the indexing model from the issue text.