Hi Sympyers, The new SymPy Documentation Style Guide that I'm putting together as part of my Google Season of Docs project with SymPy <https://developers.google.com/season-of-docs/docs/participants/project-sympy> is now available on the SymPy Wiki: https://github.com/sympy/sympy/wiki/SymPy-Documentation-Style-Guide
You'll notice that some of the new guidelines in the guide are qualified with a Work in Progress note and an issue number. These are guidelines that are dependent on resolving certain issues in order for the guide to be implemented. If you are interested in working on any of these issues, the full listing of Google Season of Docs related issues can be found here: https://github.com/sympy/sympy/milestone/54 We would love to have some feedback from the SymPy community on the first draft of this new style guide. In particular, we would like to know your thoughts on these two issues: 1. What do you think of the new order for docstring sections <https://github.com/sympy/sympy/wiki/SymPy-Documentation-Style-Guide#docstring-sections>? Do you think it is more helpful for examples to occur earlier in the docstring to learn by example, or do you prefer to have all of the information about a function, such as parameters, before seeing the examples? 2. How do you think docstrings for classes that are mathematical functions <https://github.com/sympy/sympy/wiki/SymPy-Documentation-Style-Guide#docstrings-for-classes-that-are-mathematical-functions> differ from other docstrings? Are there any other details you would like to see included in this section? Please feel free to share any other feedback you may have about the new guide. Please share any feedback you have by October 21st to allow for ample time for concerns to be addressed. After October 21st I will be finalizing the guide and starting the process to merge it with SymPy's documentation. Thank you in advance for your thoughts and comments! Lauren -- 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 [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/sympy/CANA%2BcPujEekMnWkFOT-cf3f5xOB1KbcUVmQcLgP26ATDhXJn%3DQ%40mail.gmail.com.
