jmanico
commented
3 years ago Absolutely I want this too! Although my main contribution as an ASVS leader is to hassle people in comments like this, I do believe we have existing automation to do document generation already - and to add a new theme for HTML generation for GitHub pages shouldn’t be that difficult.
-- Jim Manico @Manicode
On Jan 15, 2021, at 6:14 AM, Josh notifications@github.com wrote:
While GitHub automatically renders the PDF stored in the repo under the corresponding version directory. It would be nice to have a linked GitHub page that automatically loads and renders from the available markdown. This would decrease the friction of trying to find/read/reference a specific section without downloading files or scrolling forever through a pdf in a subdirectory.
The simplest option might just be to have a static HTML file that uses docsify to dynamically load all the markdown. Or if indexability and speed are worth the additional complexity, a github action could be set up to statically generate the page with its content.
— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub, or unsubscribe.
sanmai-NL
tghosth
cmlh
jefmeijvis
While GitHub automatically renders the PDF stored in the repo under the corresponding version directory. It would be nice to have a linked GitHub page that automatically loads and renders from the available markdown. This would decrease the friction of trying to find/read/reference a specific section without downloading files or scrolling forever through a pdf in a subdirectory.
Though I suppose if this were to be done, it would be preferable to render it to page for the OWASP site like is done for the WSTG.
The simplest option might just be to have a static HTML file that uses docsify to dynamically load all the markdown. Or if indexability and speed are worth the additional complexity, a github action could be set up to statically generate the page with its content.