Closed bashbaug closed 2 years ago
Maybe we should consider not inlining the CSS for the refpages? Mostly to make the PR diff listing more comprehensible, more than for space savings.
Yeah, I noticed that. We updated the stylesheets and there are a lot more diffs this time than there were previously.
Is this an easy change to the reference page toolchain?
Yeah, I noticed that. We updated the stylesheets and there are a lot more diffs this time than there were previously.
Is this an easy change to the reference page toolchain?
Yes. I can prototype it if you like (please open a tracking issue against me if so), or you can look at https://docs.asciidoctor.org/asciidoctor/latest/html-backend/stylesheet-modes/#embed . TL;DR will need to set the linkcss and copycss attributes appropriately. We don't do this by default since there's some value in keeping the files entirely self-contained and some slight complexity in getting the right stylesheet bundled with the refpages - but the process looks to have gotten a bit simpler since we made that decision years ago in Vulkan.
Closing - we should merge the v3.0.11 reference pages instead (https://github.com/KhronosGroup/OpenCL-Registry/pull/122).
Updates the online OpenCL reference pages for the v3.0.10 specs.