-
-
Notifications
You must be signed in to change notification settings - Fork 8.3k
Closed
Labels
Milestone
Description
Hey all - these are some quick issues I ran across when following the documentation guidelines. I can open a PR to fix them later (once I get the docs finally built) but want to make sure all the points I ran into are worth changing:
- There are extra dependencies not listed there. In particular a Latex package with at least the package "type1cm". It would be helpful to point people to a latex distribution page if necessary.
- When I was trying to build the docs initially I ran into a bunch of weird errors where the answer was usually solved by deleting a folder that is auto-generated by the docs build (e.g. the
examplesfolder w/ the rendered rst files etc). It might be useful to include a quick section like "if something doesn't work and you can't find the answer here, try these steps to see if it fixes things". I'm imagining something like how I tell people "did you turn your computer off and on?" when they have computer problems. - There's a dependency on graphviz. Can't remember if this is documented or not but in case it's not I'm putting this here.
If anything else comes up I can bring it up here, this will serve as a placeholder for my own experience. @NelleV if you can remember anything that came up when we were doing this before then feel free to note here and I can make a change to the docs later on.
Reactions are currently unavailable