Rationale
See GitHub issue #545 for the work to migrate the page management system (JAM stack, Static Site Generation). The stated reasons for this migration effort include:
- The current Jekyll-based solution is fragile and brittle - dependencies can be frequently updated and typically rely on differing versions of shared libraries
- complex to learn and support - it's easy to install or use the wrong libraries and misconfigure the ruby environment so badly that you cannot preview pages
- does not support different versions per branch - as we begin to use two or more branches at once, it is important to keep the diverging features documented separately (in their own branch)
- Documentation is generated in Markdown, associated with each repository, moved to
open-horizon.github.io
repo when merged, and the site is generated in Jekyll with keywords abstracted out and inserted at page generation time.