You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
There are some issues with the structure of the PDF, so I have not yet posted it.
For example, the ToC for the PDF in 3.5.0 looks like:
compared with the HTML which looks like:
The 'Installing from source' and 'Installing FAQ' both appear before the 'Installation' page, but are hidden in the HTML version.
@jklymak@timhoffm You last re-arranged the docs to have Tutorials/Examples first, and then the General guide:
This is OK in the website, because we have the top bar that can link to any of those.
But in the PDF, it's all very linear, and it seems odd to have a bunch of tutorials first, followed by a Getting Started and Installation Guide:
Since this doesn't really affect the HTML site that much, what do you think of re-ordering these?
I have the feeling that this is the result of not having a clear hierarchical structure in the docs. But I don't want to dive down into docs structure again right now. So I'm fine with any solution that works to fix the PDF.
The PDF is now 109.59 MB and gets blocked by GitHub for being too large. I'm not sure why it ballooned so much, but we'll have to shrink it in order to put it online.
Activity
QuLogic commentedon Nov 17, 2021
@jklymak @timhoffm You last re-arranged the docs to have Tutorials/Examples first, and then the General guide:

This is OK in the website, because we have the top bar that can link to any of those.
But in the PDF, it's all very linear, and it seems odd to have a bunch of tutorials first, followed by a Getting Started and Installation Guide:

Since this doesn't really affect the HTML site that much, what do you think of re-ordering these?
jklymak commentedon Nov 18, 2021
@timhoffm was the proponent of reordering them. I'm fine either way.
jklymak commentedon Nov 19, 2021
The other approach is to just have the TOC in the middle of the page, and
instead of explicit TOC here..
timhoffm commentedon Nov 20, 2021
I have the feeling that this is the result of not having a clear hierarchical structure in the docs. But I don't want to dive down into docs structure again right now. So I'm fine with any solution that works to fix the PDF.
QuLogic commentedon Dec 7, 2021
The PDF is now 109.59 MB and gets blocked by GitHub for being too large. I'm not sure why it ballooned so much, but we'll have to shrink it in order to put it online.
QuLogic commentedon Dec 14, 2021
The PDF has now been shrunk and uploaded with 3.5.1; I will not attempt to fix it for 3.5.0.