Documentation improvements to consider - sympy/sympy GitHub Wiki
Status flags:
(E) = endorsed in SymPy community (on Google Group, GitHub, etc.)
(I) = issue created
(P) = pull request
(M) = pull request merged
Improvements to consider:
General
Feature @SymPy twitter account on documentation template
(I-22652P-22709 M) Navigation: Last page of a sections should have Next topic = index of next section, namely
Last page of Tutorial should have Next topic = Guides
Last page of Guides should have Next topic = Explanation
(E I-22716) Improve documentation formatting by changing Sphinx theme
Create pull request for PyData
Create pull request for Book
Set width and height of SymPy logo: Image elements do not have explicit width and height
Set an explicit width and height on image elements to reduce layout shifts and improve CLS. "../_static/sympylogo.png"
Display the Diataxis category even more prominently, in addition to breadcrumbs at the top of each page.
Improve explanation of how to update, build, and test documentation. Instructions are currently spread across multiple pages (Development workflow wiki, Documentation style guide), and there is no example of the whole process.
(I-22629P-22629) Reorder guides: Put Contributing to SymPy last
(E) Solvers: first explain how to solve equations and inequalities, particularly explaining the strengths of different solvers, when to use each, and giving examples of each
(E) Add an example to solveset() on how to solve a set of equations or inequalities in a single variable (if it does--the documentation is ambiguous on whether this is even possible)
(E) Add an example to solve() on how to solve a set of equations or inequalities, in a single variable, then in multiple variables (if possible)
What kinds of things you can do with SymPy (Calculus, Linear Algebra, etc.), as the wiki tutorial nicely does
State that venv folder needs to be named .venv because that's what's in gitignore. May need to add instructions for creating virtual environment using straight Python (not Anaconda).
(E) At the top of each of the low-level solvers pages, put a note that you probably want to use a high-level solver instead--I reached the inequalities solvers page via a web search, and thought I had to use it instead of solve
(E) Use simpler math for examples, or at least the first example for a function. For example, that page on solving inequalities has as its first example the following. I didn't know what the Poly function was (plus I couldn't find documentation for it), so I couldn't understand the solver.