Re: Roadmap to Euphoria 4.2
- Posted by _tom (admin) Sep 05, 2019
- 1227 views
ll that being said, I don't think it's time to move to a new documentation system. Let's focus on the correctness of what we've got now, and revisit that after a release.
-Greg
eudoc/creole works to create docs for
- wiki html
- pdf (via wkhtmltopdf)
nothing wrong with creole markup syntax because it was designed to be generic and intuitive
The missing final step is to provide a single download so users can have offline html docs that provide:
- tree navigation
- better searching
- indexing
The CHM format takes html and puts into a single download--with navigation and searching. The curse is: even Microsoft has abandoned the format, Microsoft makes it messy to create; CHM was never fully adopted by Linux. CHM is not an obvious solution to docs even if Phix uses it.
the workflow for creating docs does not have to change--only a few improvements can come later
_tom