KhronosGroup / KhronosGroup/Vulkan-Docs

Issue with rendering pipeline stages ordering in core spec build

Open
#2,488 0 comments 0 reactions 0 assignees View on GitHub
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:

![Image](https://github.com/user-attachments/assets/db2fb0a2-fb0c-4e37-a176-dc9aa782607f)

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):

![Image](https://github.com/user-attachments/assets/ad9634b9-0894-4964-b73e-ac219487cd28)

This issue persists when i execute command
```bash
./makeSpec -clean -spec core chunked
```

But renders correctly when using `-spec` `khr/ratified/all`.

Contributor guide

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.