KhronosGroup / KhronosGroup/Vulkan-Docs
Issue with rendering pipeline stages ordering in core spec build
- Dominant language
- JavaScript
- Stars
- 3.3k
- Forks
- 549
- Avg merge
- 5d 5h
- Merged PRs (30d)
- 2
Description
There is a logical ordering between certain pipeline stages listed in the Chapter 7.1.2:

However, if i follow standard build instructions (using `./runDocker` script), i got the Specification with incorrectly rendered this part of the document, no matter the output format (pdf/chunked/html):

This issue persists when i execute command
```bash
./makeSpec -clean -spec core chunked
```
But renders correctly when using `-spec` `khr/ratified/all`.
Contributor guide
Research direction
Start with the ./runDocker and ./makeSpec entry points, reproducing the core chunked build with ./makeSpec -clean -spec core chunked and comparing it with khr/ratified/all. Trace how Chapter 7.1.2 is rendered across PDF, chunked, and HTML outputs; done means the pipeline stages appear in the logical order in every format.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- build-system, documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100