[idea] using markdown instead of LyX?
Just an idea, but why not write the guide in markdown, which many developers are familiar with, and publish the docs online as HTML to make things easier?
If PDF is a valued output, there are also markdown-to-pdf tools.