Some improvements needed to vkconfig automatic layer setting doc generation? #1656
Labels
documentation
OS - platform independent
The issue doesn't depend on the OS
Project - vkconfig
Issues related to vkconfig
When we were moving all of the layers to automatically have their layer settings documentation automatically generated, there were some concerns about the readability of the automatically generated documentation from the GFXReconstruct repository. So we delayed moving the GFXReconstruct repository to using the automatic layer setting documentation approach until this issue could be resolved. @bradgrantham-lunarg please add any additional information to this issue that you may have.
Some examples of the concerns:
The generated documentation is not as clear as the hand-written table that's there now.
Table that was in the USAGE markdown:
It's clear what the environment variable value is, it's clear what the description is, and the alternating white/gray rows separate the options well.
What it will be when generated:
It's harder to figure out which is which, "Capture Specific Frames" (the setting) is not very different from "Setting Properties" (a header every setting has). I feel like this is just a word waterfall that has to be parsed for the meaning. "Setting Default Value" is on the same line as "Setting Type". The "Setting Properties" aren't split or aligned like a table so my eye has to search for the bits.
The text was updated successfully, but these errors were encountered: