Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Jason Moore
Lauren, Great summary! Looking forward to what you can do with the info. Jason moorepants.info +01 530-601-9791 On Tue, Aug 13, 2019 at 4:08 PM Lauren Glattly wrote: > I agree with Jason that a proper survey on how the SymPy documentation is > used and by who could be helpful. One of the bigg

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Lauren Glattly
I agree with Jason that a proper survey on how the SymPy documentation is used and by who could be helpful. One of the biggest conversations of Google Season of Docs (and something I'm seeing with other open source software projects) is "who is the audience of our documentation" and "how can it be

Re: [sympy] Starting to think about 1.5 release

2019-08-13 Thread Aaron Meurer
Yes, I forgot about the release notes. The release notes are collected automatically on every pull request by a bot, so they are pretty accurate, but we will also need someone to manually collect the important changes at the top in the "Highlights". We should at least mention every GSoC project the

Re: [sympy] Starting to think about 1.5 release

2019-08-13 Thread Oscar Gustafsson
These are the current release notes, so nothing summarized really: https://github.com/sympy/sympy/wiki/Release-Notes-for-1.5 BR Oscar Den tis 13 aug. 2019 21:48David Bailey skrev: > On 12/08/2019 22:27, Aaron Meurer wrote: > > Now that GSoC is wrapping up (this is the last week), I'd like to >

Re: [sympy] Starting to think about 1.5 release

2019-08-13 Thread David Bailey
On 12/08/2019 22:27, Aaron Meurer wrote: Now that GSoC is wrapping up (this is the last week), I'd like to start thinking about the next release of SymPy. Is there a link to anything that will describe what 1.5 will (fairly definitely) contain? David -- You received this message because you

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Jason Moore
> I don't know that for sure, so maybe there is some way we could measure that. This is something Lauren could do, a proper survey to solicit feedback on docstrings/documentation from users would really help. Right now we are just getting info from a few vocal speakers. > Maybe our docstring stan

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Aaron Meurer
We can write a Sphinx extension that lets you write .. sympy:: Eq(uppergamma(s, x), Integral(t**(s - 1)*exp(-t), (t, x, oo))) and Sphinx will pass the string through latex(sympify(...)). That way we get the best of both worlds. The downside is that you are much more limited in what you can re

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Ondřej Čertík
On Tue, Aug 13, 2019, at 10:49 AM, Jason Moore wrote: > > I don't know that for sure, so maybe there is some way we could measure > > that. > > This is something Lauren could do, a proper survey to solicit feedback > on docstrings/documentation from users would really help. Right now we > ar

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Ondřej Čertík
On Tue, Aug 13, 2019, at 8:32 AM, Fredrik Johansson wrote: > On Tuesday, August 13, 2019 at 8:59:23 AM UTC+2, Aaron Meurer wrote:On > Mon, Aug 12, 2019 at 8:39 PM Ondřej Čertík wrote: > > > > > > > > > > > > On Mon, Aug 12, 2019, at 7:47 PM, Aaron Meurer wrote: > > > > A possible middle g

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Jason Moore
> I like this approach a lot. I agree. It is a nice idea. Jason moorepants.info +01 530-601-9791 On Tue, Aug 13, 2019 at 10:22 AM Ondřej Čertík wrote: > > > On Tue, Aug 13, 2019, at 10:49 AM, Jason Moore wrote: > > > I don't know that for sure, so maybe there is some way we could > measure th

[sympy] Newcomer here

2019-08-13 Thread Soniya Nayak
Hi, I am Soniya Nayak. I am currently in my third year of B Tech. in Computer Science and Engineering at IIT(ISM) Dhanbad. I was a Microsoft last summer where I developed an interest in open source. SymPy seemed like a good place to start:) I know basics of python and would love to contribute.

Re: [sympy] Newcomer here

2019-08-13 Thread Aaron Meurer
It is not necessary to set up the sympy-bot. The bot runs automatically. Those instructions you found are there for people who are developing the on the bot itself. It would be helpful to know how you found your way to the sympy-bot instructions, since they aren't relevant for new contributors, so

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Aaron Meurer
On Tue, Aug 13, 2019 at 10:49 AM Jason Moore wrote: > > > I don't know that for sure, so maybe there is some way we could measure > > that. > > This is something Lauren could do, a proper survey to solicit feedback on > docstrings/documentation from users would really help. Right now we are just

Re: [sympy] Newcomer here

2019-08-13 Thread Soniya Nayak
I am stuck at setting up the sympy-bot for pr testing. How to I create a new webhook as mentioned in the instructions? On Tuesday, August 13, 2019 at 10:23:13 PM UTC+5:30, Jason Moore wrote: > > Soniya, > > Welcome. If you haven't found this page yet: > https://github.com/sympy/sympy/wiki/introd

Re: [sympy] Newcomer here

2019-08-13 Thread Jason Moore
Soniya, Welcome. If you haven't found this page yet: https://github.com/sympy/sympy/wiki/introduction-to-contributing it is a good place to get started. Let us know if you have any questions. Jason moorepants.info +01 530-601-9791 On Tue, Aug 13, 2019 at 9:13 AM Soniya Nayak wrote: > Hi, > >

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Jason Moore
I was thinking more about Aaron's mention of measuring the documentation use and started wondering how to get more and better insight into what is good and bad about our documentation. One issue that this conversation suffers from is that Aaron probably knows more about SymPy that almost anyone. On

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Jason Moore
Here is another example taken from physics.vector.point. There is a method that calculates an acceleration ( https://github.com/sympy/sympy/blob/master/sympy/physics/vector/point.py#L57). The docstring is currently: """Sets the acceleration of this point with the 1-point theory. T

Re: [sympy] Re: Google Season of Docs Participants Announced

2019-08-13 Thread Fredrik Johansson
On Tuesday, August 13, 2019 at 8:59:23 AM UTC+2, Aaron Meurer wrote: > > On Mon, Aug 12, 2019 at 8:39 PM Ondřej Čertík > wrote: > > > > > > > > On Mon, Aug 12, 2019, at 7:47 PM, Aaron Meurer wrote: > > > A possible middle ground would be to print the definition as a SymPy > > > expression. T