Hi all, I am working on a large scale docstring formatting PR (https://github.com/sagemath/sage/pull/38155), and I invite you to come and share your opinions and help with the review process.
Some comments from me, from things that I've noticed: There are many inconsistencies in formatting and trivial syntactical/grammatical errors. It may be my own sensibilities, but this exudes a lack of professionalism which undermines the whole Sage project. This I believe is not solely an aesthetic issue: a more professional appearance can inspire more serious work from users and developers. It also makes later decisions and changes in style more easily applicable. My recommendations are the following: 1. Reach a decision upon all matters of style; 2. Write a script to enforce a consistent style (a new CI test). -- 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/66a6d5d3-df15-4c66-bd42-ecbc0275ce6an%40googlegroups.com.
