Dear Stefan,<br><br>Really appreciate you taking the time to address this, and your suggestion sounds really valuable.<br><br>Having everything together – TeXworks msnual and the API help (TwScript :-) would be great.<br><br>Henrik's suggestion on Bookdown looks very good. I should not be surprised if that could some how be used to some useful degree in a GitHub environment.<br>The extended MD syntax of Bookdown certainly looks very useful.<br><br>Even if the MD source files were to be taken client side and put through Pandoc, and the results uploaded back to the Git hub repository, we'd still have a central editable repository for the source files.<br><br>I know that MD —> Pandoc produced html can also be uploaded to GitHub as a static website.<br><br>I might be out of touch for just a few days. If Henrik is still following this thread, his thoughts and others' might also be valuable at this point.<br><br>There may be other options for a compliant repository for theBookdown MD, perhaps others might chime in here, the Bookdown reccomendation I think handles everything out of the box for "post-production" (html pdf docx) I think(?)<br>If that is not essential then GitHub would be great. <br><br>I do believe that the application I've been using to make the TwScript API help – html pdf etc. – HelpnDoc, can throw out MD (I think that they list three available dialects) so that may give us a base to start from using the work already done to date to seed the new project.<br><br>Going forward I could put a redirect on the existing TwScript api web site as well.<br><br>If we can settle on simillar if not identical processes for the TeXworks main manual, and repository, it would make a lot of sense.<br><br>There may be a way to process the existing TeXworks manual's work to MD to seed it's initial project as well. <br>If not from pure LaTeX(?) then initially from the html to MD may be feasible.<br><br>Seems things are starting to look good on this documenation front overall :-)<br><br>Paul<br><br>On Saturday, 5 June 2021, Stefan Löffler <<a href="mailto:st.loeffler@gmail.com">st.loeffler@gmail.com</a>> wrote:<br>> Dear Paul,<br>><br>> sorry for not writing sooner, busy as always... :/<br>><br>> On 30.04.21 09:40, Paul A Norman wrote:<br>><br>> Thanks Henrik,<br>> That is certainly very helpful.<br>> "A nice example is the bookdown R package, that makes it easy to suggest a change to a book through a github pull request.<br>> You can see it in action here —<br>> <a href="https://bookdown.org/yihui/bookdown/">https://bookdown.org/yihui/bookdown/</a><br>> I know that other LaTeX documentation is produced through intermediary formats, and this one is looking like a good approach.<br>><br>> We may need, whatever option is followed, some sort of "safe" server, as all too often for commercial or other reasons, public "free" hosting options are withdrawn often with little or no warning. May be in this case the situation is safer?<br>><br>> If it helps, I can definitely create a new repository on Github in the "TeXworks organization" and give you write access to it.<br>><br>> In fact, I was going to propose to look into the markdown support for Github Pages (i.e., writing stuff in markdown, publishing it to Github, and getting it rendered nicely). The result would be something akin to <a href="https://stloeffler.github.io/texworks-testing/">https://stloeffler.github.io/texworks-testing/</a> (the theme is customizable ;)), though probably at a url similar to <a href="http://texworks.github.io/js-api-doc">texworks.github.io/js-api-doc</a>.<br>><br>> I am quite happy to just dive into any realistic option, and MarkDown as provided up by Bookdown is looking like a very viable option indeed.<br>><br>> Not sure what the differences (benefits) are between MarkDown and BookDown...<br>><br>> Anyway, please let me know what you find, as I have been toying with the idea of converting the "main" manual to markdown as well (for easier writing, editing, and conversion to multiple formats).<br>><br>> HTH<br>> Stefan<br>>