OWASP / IoT-Security-Verification-Standard-ISVS

OWASP IoT Security Verification Standard (ISVS)
Other
133 stars 49 forks source link

Replace GitBook #83

Closed scriptingxss closed 1 year ago

scriptingxss commented 3 years ago

GitBook hosting has been an issue due to Github account requirements (tied to one user) along with formatting constraints. We want to explore static site generators that are easy to maintain, provide free hosting, and enable formatting customizations to illustrate emphasis where needed.

MKDocs https://www.mkdocs.org/ https://github.com/gristlabs/mkdocs-windmill https://mkdocs.github.io/mkdocs-bootswatch/ https://github.com/squidfunk/mkdocs-material Cheat sheet series uses this

Jekyll - Preferred option https://jekyllrb.com/ Theme https://github.com/pmarsceill/just-the-docs - maybe with this or another theme and a color that aligns with owasp projects GitHub Pages utilizes Jekyll https://pages.github.com/ https://dev.to/ows_ali/how-to-host-a-static-website-on-github-for-free-2pd1

Note: Modifying the report structure may bread the document build actions and will need to be updated.