Thank you for all the work you've done here Jeremy. It sounds like the Furo theme is the winner. I also like it the best, because I think it does the best job with the sidebars (there are some styling aspects of it that I don't like, but those are easy to change in the CSS).
I've started a pull request proposing the Furo theme with several CSS modifications to make it styled better (green colors, and so on) here https://github.com/sympy/sympy/pull/23159. There is a demo site built at https://www.asmeurer.com/sympy-furo-demo/ Any comments on my styling fixes are welcome. I'm not really a CSS expert so please let me know if you see something that is difficult to read or should otherwise be improved. Aaron Meurer On Fri, Feb 25, 2022 at 5:24 PM Jeremy Monat <jemo...@gmail.com> wrote: > > Hello SymPy community, > > SymPy ran a user survey about its documentation theme from February 5-19, > 2022. The primary purpose of the survey was to guide the selection of a > Sphinx theme for the SymPy Documentation at https://docs.sympy.org. We thank > everyone who took and shared the survey. > > Even though the survey is no longer open, we still welcome feedback on > SymPy's documentation. Feel free to reach out to us on the mailing list, or > in the Github issue to change the Sphinx theme. > > I have written up an analysis of the results at > https://www.sympy.org/sympy-docs-survey/2022-theme-survey.html (thanks to > Aaron Meurer for some analysis code, and posting the analysis there). The > source code for the > Jupyter notebook can be found at https://github.com/sympy/sympy-docs-survey. I > have included a summary of this analysis here. > > A total of 22 people responded. The survey was done on Google Surveys and was > shared on the SymPy public mailing list, the @SymPy Twitter account, and a > SymPy discussion on GitHub. The survey consisted of 14 questions, all of > which were optional. The results of these responses are summarized here. We > would like to thank everyone who took and shared the survey. > > At a high level, there are three main takeaways from the results. > > The themes can be divided into three ratings categories, where the rating > scale was 1 (Not very useful) to 4 (Very useful): > > Highest: Furo at 2.95. > Middle: PyData and Book, nearly tied at 2.85 and 2.86, respectively. > Lowest: Read the Docs (RTD) at 2.47. > > Most comments about themes, both likes and dislikes, were about formatting, > look and feel, and navigation. > > We should proceed with the Furo theme, customizing it to address respondents' > dislikes about its formatting. We can keep the PyData and Book themes in mind > as backup options. > > Again, I would like to thank everyone who took the time to fill out this > survey. It really helps us to have your feedback. > > Jeremy Monat > > -- > You received this message because you are subscribed to the Google Groups > "sympy" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to sympy+unsubscr...@googlegroups.com. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sympy/ae6935a1-d638-4265-a094-bd59f1dfc643n%40googlegroups.com. -- You received this message because you are subscribed to the Google Groups "sympy" group. To unsubscribe from this group and stop receiving emails from it, send an email to sympy+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sympy/CAKgW%3D6K-YxQJkvfrsMkCq-O4fesYpAowo2-Y3A3MuOA_J_Ko0w%40mail.gmail.com.
