Not sure whether switching Sage to standard Sphinx/Python docbuilding tools falls within the remit of the Season of Docs, but it's surely a worthwhile project - in particular if we can get funds for it.
On Sun, Mar 10, 2024 at 3:03 PM David Roe <roed.m...@gmail.com> wrote: > I think this would be good for Sage. I think there are several decisions > to be made: > * What are our most pressing documentation needs? Personally, I think we > have a gap between the reference manual (which is extensive but has no > flow) and the thematic tutorials (which are written to tell a story but are > just introductions). I also poked around online for criticisms of Sage's > documentation and found complaints about not having separate pages for > each function <https://news.ycombinator.com/item?id=23513654> (compared > to Mathematica's), some suggestions here > <https://www.reddit.com/r/math/comments/45q7j1/sagemath_open_source_is_now_ready_to_compete_with/> > about focusing on aspects of Sage commonly used by beginners (like > plotting). > * Who will be involved in applying and supervising the project? This > could be a group or a single person. I can help a bit, but I can't take > the lead. > David > > On Sat, Mar 9, 2024 at 5:13 PM Matthias Koeppe <matthiaskoe...@gmail.com> > wrote: > >> SageMath could benefit from hiring a technical writer for a project to >> improve the Sage documentation. Google Season of Docs is a program that >> supports such projects. Some key facts: >> - total project budget $5,000 - $15,000 USD (via OpenCollective) - >> https://developers.google.com/season-of-docs/docs/org-payments >> - starts April 10 (or May 22 the latest), ends November 22, 2024 - >> https://developers.google.com/season-of-docs/docs/timeline >> >> Several of our peer projects (NumPy, Matplotlib, SymPy, R, Geomstats) are >> among the orgs that appear to have made successful use of this program in >> the past few years, see >> https://developers.google.com/season-of-docs/docs/2023/participants etc. >> >> Thoughts? >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sage-devel" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to sage-devel+unsubscr...@googlegroups.com. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/sage-devel/32bf06f2-6c35-40a9-855c-857c7af23799n%40googlegroups.com >> <https://groups.google.com/d/msgid/sage-devel/32bf06f2-6c35-40a9-855c-857c7af23799n%40googlegroups.com?utm_medium=email&utm_source=footer> >> . >> > -- > You received this message because you are subscribed to the Google Groups > "sage-devel" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to sage-devel+unsubscr...@googlegroups.com. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sage-devel/CAChs6_mEgnbGQgJQHuT9rXLJZMtitYe1CxkUG9Fy0iFGqONRHg%40mail.gmail.com > <https://groups.google.com/d/msgid/sage-devel/CAChs6_mEgnbGQgJQHuT9rXLJZMtitYe1CxkUG9Fy0iFGqONRHg%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/CAAWYfq31NYoF%3D160t1iTw%3DH_0J9XYHqxHEwGrjuPAvRhFfNYCg%40mail.gmail.com.
