That is interesting. I changed from that behaviour as more than once the docs and the pdfs were not updated in sync.
They don't have to be updated in sync. The only time they need to be synced is just before release. Every two or three years (or 5+ in our case).
Thus a developer would simply have to update the odt, the rest would be automatic. Also for users it would just take a moment to check the version on the page to tell if they are looking at the correct documentation.
Perfectly ok with that, provided that it works. The problem is that it currently doesn't work. Either it gets fixed to work, or it gets reverted to the past state.
You're welcome to press ahead with the 1.92 release and we can look at readthedocs after.
My fixed up reference sheet odt to test is now here as I renamed that branch: https://github.com/mcarans/oolite/blob/ ... liteRS.odt. However, I looked at the generated one in the .exe and it looks better so I think someone with a working LibreOffice will need to fix up the original file to remove Mac keys etc. (and any other odt files that need fixing) because the layout is nigh on unfixable in my version. Aside from the layout issues, it's hard to track changes in GitHub compared to other textual formats.
Apparently there's a new simpler typesetting alternative to LaTeX (which I never learnt) called Typst: https://github.com/typst/typst. Looks nice, but maybe markdown is good enough.
Glad to see it was a trivial fix after all. The PR has been merged.
My fixed up reference sheet odt to test is now here as I renamed that branch: https://github.com/mcarans/oolite/blob/ ... liteRS.odt. However, I looked at the generated one in the .exe and it looks better so I think someone with a working LibreOffice will need to fix up the original file to remove Mac keys etc. (and any other odt files that need fixing) because the layout is nigh on unfixable in my version. Aside from the layout issues, it's hard to track changes in GitHub compared to other textual formats.
Checked your .odt and yeah, it is kind of OK but not exactly perfect on my LibreOffice. Don't worry about it, I'll try to set time aside to work on removing the deprecated stuff and getting the docs finalized. I may need some help with the Linux parts of the Readme though as far as correctness of information is concerned.
Looks great, fantastic job. Thank you very much! Again, if there are any comments for improving the actual text of the policy from anyone reading here, they are most welcome.
The odt looks good in both 25.2.7 and 25.8.4 on my archlinux system.
I changed from Ubuntu's repo to LibreOffice's own to get 25.8.4.2 but that didn't fix the issue. However, I found the issue - another missing font not Microsoft TTF. I had to install: sudo apt install fonts-dejavu-extra
This gave me the missing DejaVu Condensed variant.
I'm gradually populating readthedocs. You can see progress here: https://oolite.readthedocs.io/en/latest/. I've made some nice tables for Oolite's controls and other things.
