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

do we need to keep producing the PDF version of the User Manual? #136

Open
iantaylor-NOAA opened this issue Jan 24, 2023 · 5 comments
Open
Labels
Priority: Low question Further information is requested User Guides

Comments

@iantaylor-NOAA
Copy link
Contributor

I find myself only using the HTML version of the manual at https://nmfs-stock-synthesis.github.io/doc/SS330_User_Manual.html. I know there are people who print the PDF, but in theory the HTML could be printed too.

I think that the compiling issues discussed in #135 would go away and it would be easier to produce an accessible (Section 508 compliant) document in HTML only and in general the document would be easier to maintain.

The formatting of the HTML isn't as good as the PDF, especially for the tables, but I think that would be easier to improve if we were focused only on one format, not two. And it makes sense to focus the energy on the format that is easiest to use and maintain, which I think is the HTML.

@iantaylor-NOAA iantaylor-NOAA added question Further information is requested User Guides Priority: Low labels Jan 24, 2023
@kellijohnson-NOAA
Copy link
Contributor

I think that keeping the pdf will allow for easier publishing of updated technical memos if we care about that. Also, I do not think that an html version will ever print as nicely as a true pdf. I use to have a strong preference for keeping it but I will default to what others want. Maybe @Rick-Methot-NOAA has thoughts?

@Rick-Methot-NOAA
Copy link
Collaborator

I agree with maintaining capability to produce a pdf.
I understand that Elizabeth was looking into conversion to Quarto, but do not know its status and how it interacts with the html/pdf issue.

@iantaylor-NOAA
Copy link
Contributor Author

I think that the conversion to Quarto will definitely make adding to and revising the User Manual easier, and I'm guessing it will help with the PDF step too. I'm not sure on status of that work, but I think it's fine to have it be on hold until Elizabeth is back from her injury.

@kellijohnson-NOAA
Copy link
Contributor

Quarto adds extra work to make the manual 508 compliant that I have not delved into as of yet. I personally advocate for native LaTeX as it currently is because you have more control but I understand that markdown is easier to read.

@Rick-Methot-NOAA
Copy link
Collaborator

I long for the days of WYSIWYG

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Priority: Low question Further information is requested User Guides
Projects
None yet
Development

No branches or pull requests

3 participants