Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation rework - part 1: Setup and conversion #439

Open
4 tasks done
GLS-SSV opened this issue Mar 4, 2024 · 4 comments
Open
4 tasks done

Documentation rework - part 1: Setup and conversion #439

GLS-SSV opened this issue Mar 4, 2024 · 4 comments

Comments

@GLS-SSV
Copy link
Contributor

GLS-SSV commented Mar 4, 2024

The first of a pair of tickets for tracking (1) the conversion of the existing documentation to LaTeX and then (2) updating and correcting the new documentation, solving the existing documentation build issues and replacing binary source files with text files.

  • Definition of styles
    Common file created.
    Orbiter logo for cover defined.
    The original font for the text is "Liberation Serif", a free alternative to "Times New Roman". Another font used is Georgia. Current font is Helvetica.
    Alert and code boxes defined.

  • Orbiter User Manual
    Mostly complete.

  • Orbiter Developer Manual
    Mostly complete.

  • Orbiter Technical Reference
    Mostly complete.

@GLS-SSV
Copy link
Contributor Author

GLS-SSV commented Mar 4, 2024

PR #438

@GLS-SSV
Copy link
Contributor Author

GLS-SSV commented Mar 5, 2024

Updated first post.
Current results:
Orbiter User Manual.pdf
Orbiter Developer Manual.pdf

@ThChicken
Copy link

ThChicken commented Jun 6, 2024

Are other documents like 3DModel.pdf in OrbiterSDK/doc being addressed by this? It seems that Chapter 7 of the Developer Manual incorporates the information in this file.

I am aware of one typo on page 5 of 3DModel.pdf, under Mesh File, that the example mesh file starts with the header "MESHX", which seems to have been replaced with "MSHX1" at some point in Orbiter history. Attempting to work with a mesh file using the MESHX header doesn't work, and only by looking at other meshes was this determined. If there is a better place to post this, let me know and I'll put it there.

Also - a lot of effort has been put into enabling Lua Scripting to make vessel add-ons as an alternative to compiling modules, but there is no mention of Lua Scripting in the Orbiter Developer Manual content outline. There is a chapter 14 titled scripting interface in the User Manual, but I think that may be just for playback and other features?

@GLS-SSV
Copy link
Contributor Author

GLS-SSV commented Sep 25, 2024

Late, but better than never...

Are other documents like 3DModel.pdf in OrbiterSDK/doc being addressed by this? It seems that Chapter 7 of the Developer Manual incorporates the information in this file.

Yes, the plan is to remove all the files in Orbitersdk/doc folder and replace them with the Orbiter Developer Manual.

I am aware of one typo on page 5 of 3DModel.pdf, under Mesh File, that the example mesh file starts with the header "MESHX", which seems to have been replaced with "MSHX1" at some point in Orbiter history. Attempting to work with a mesh file using the MESHX header doesn't work, and only by looking at other meshes was this determined. If there is a better place to post this, let me know and I'll put it there.

What was done so far was the conversion of the existing files into the 3 docs (and the occasional typo fix, like that one), and part 2 will now update and correct bugs. Issues should be reported in the second ticket (#440), so it is all in one place.

Also - a lot of effort has been put into enabling Lua Scripting to make vessel add-ons as an alternative to compiling modules, but there is no mention of Lua Scripting in the Orbiter Developer Manual content outline. There is a chapter 14 titled scripting interface in the User Manual, but I think that may be just for playback and other features?

In the conversion I kept things mostly as they were in the original docs, leaving the updating and additions for later, and AFAIR there was no chapter for Lua in the original doc.
The Lua documentation should also be part of the Orbiter Developer Manual, but it seems that part is going a different way....

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants