KhronosGroup / KhronosGroup/OpenGL-Refpages

Fix exposed JavaScript problem in older pages

Open
#8 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
492
Forks
146
PR merge metrics
No merged PRs in 30d

Description

Per https://www.khronos.org/bugzilla/show_bug.cgi?id=1404 - in some browsers, JavaScript (possibly inserted by the site framework?) appears in older ref pages like

https://www.khronos.org/opengles/sdk/docs/man/

Fixing this for very old pages isn't a priority but just to keep track of this as we migrate away from Bugzilla. The eventual solution might be to move the pages to asciidoc instead of Docbook, since we know that doesn't present any problems with e.g. the Vulkan pages, and they are far easier to edit. But a good converter for \-style Docbook is needed and I haven't found one yet.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the linked Khronos Bugzilla report and inspect the older OpenGL ES reference pages at khronos.org/opengles/sdk/docs/man/. Compare the generated pages with the Vulkan pages, then determine whether the exposed JavaScript can be fixed in the current Docbook output or requires a Docbook-to-Asciidoc migration. Done means the older pages no longer expose the unwanted JavaScript, with the conversion path understood if migration is required.

Written by the indexing model from the issue text.

Assessment

Tech stack
html, javascript
Domain
documentation
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.