Re: [SciPy-Dev] Google Season of Docs
I created a first draft in a forked repo: https://github.com/chrisb83/gsod/blob/gsod-stats/2019/SciPy_ideas_list.md Feedback is welcome! https://github.com/chrisb83/gsod/pull/1 On Thu, Apr 4, 2019 at 4:43 PM <scipy-dev-request@python.org> wrote:
Send SciPy-Dev mailing list submissions to scipy-dev@python.org
To subscribe or unsubscribe via the World Wide Web, visit https://mail.python.org/mailman/listinfo/scipy-dev or, via email, send a message with subject or body 'help' to scipy-dev-request@python.org
You can reach the person managing the list at scipy-dev-owner@python.org
When replying, please edit your Subject line so it is more specific than "Re: Contents of SciPy-Dev digest..."
Today's Topics:
1. Re: Google Season of Docs (Ralf Gommers) 2. Re: GSoC 2019 Projects (Gregory Lee)
----------------------------------------------------------------------
Message: 1 Date: Thu, 4 Apr 2019 13:26:40 +0200 From: Ralf Gommers <ralf.gommers@gmail.com> To: SciPy Developers List <scipy-dev@python.org> Subject: Re: [SciPy-Dev] Google Season of Docs Message-ID: <CABL7CQg5Qyjb= xf_JMmAOvLamd330m47E1Y356-cLfj99TOXKA@mail.gmail.com> Content-Type: text/plain; charset="utf-8"
On Wed, Apr 3, 2019 at 11:49 PM Paul van Mulbregt < p.vanmulbregt@comcast.net> wrote:
I can be a second mentor for the stats documentation proposal.
Great, thanks Paul!
-Paul
On Apr 3, 2019, at 3:12 PM, Christoph Baumgarten < christoph.baumgarten@gmail.com> wrote:
Sure, I will add it in the next few days.
On Tue, Apr 2, 2019 at 6:02 PM <scipy-dev-request@python.org> wrote:
Send SciPy-Dev mailing list submissions to scipy-dev@python.org
To subscribe or unsubscribe via the World Wide Web, visit https://mail.python.org/mailman/listinfo/scipy-dev or, via email, send a message with subject or body 'help' to scipy-dev-request@python.org
You can reach the person managing the list at scipy-dev-owner@python.org
When replying, please edit your Subject line so it is more specific than "Re: Contents of SciPy-Dev digest..."
Today's Topics:
1. Re: Google Season of Docs (Ralf Gommers)
----------------------------------------------------------------------
Message: 1 Date: Tue, 2 Apr 2019 10:40:20 +0200 From: Ralf Gommers <ralf.gommers@gmail.com> To: SciPy Developers List <scipy-dev@python.org> Subject: Re: [SciPy-Dev] Google Season of Docs Message-ID: <CABL7CQipvttnWrAE= V6Fr+iJKjGM1x0wgKbK-ea7ZNsOXx6YDg@mail.gmail.com> Content-Type: text/plain; charset="utf-8"
On Fri, Mar 22, 2019 at 8:07 PM Ralf Gommers <ralf.gommers@gmail.com> wrote:
On Thu, Mar 21, 2019 at 12:10 PM Christoph Baumgarten < christoph.baumgarten@gmail.com> wrote:
Hi,
taking up Ralf's mail on GSoD, I had a look at the website and
apply.
My project suggestion would be to work on the documentation of a module like stats:
- improve the tutorial site https://docs.scipy.org/doc/scipy/reference/tutorial/stats.html - improve the documentation of the API - check whether current descriptions can be improved - add examples and references - cross-ref to other relevant / similar functions in the module
The second point would require decent knowledge of statistics whereas
propose to the
first point should be easier to tackle for a technical writer. So I see the second point as optional and one could also try to work on the tutorial site of more than one module during the 3-month period.
The task would leave quite a bit of freedom to the writer to choose what areas to focus on, potentially taking up some of the documentation issues that are already on Github.
I could assist as a mentor for stats (we need at least two mentors).
Any suggestions or comments?
Thanks Christoph, this sounds like a good idea to me. We have a lot of content on scipy.stats, and a tech writer could really make a difference in making that easier to understand for users. I suggest we write this up as an idea on our (to be created) ideas page as soon as we know whether we have an umbrella organization that we can participate with.
An update on this: NumFOCUS is applying as an umbrella org. We'll need to add our ideas at https://github.com/numfocus/gsod/blob/master/2019/SciPy_ideas_list.md. Since there are going to be few spots available, it's the quality of the content that matters for acceptance of NumFOCUS as an umbrella org. We should have 1-2 ideas that are well described up on that page by April 14th. There are some guidelines at
https://developers.google.com/season-of-docs/docs/project-ideas#project-idea
Christoph, could you add your idea in that SciPy_ideas_list.md file?
I will add some more general information there about getting started on the SciPy docs. Also, if anyone has another idea, that would be great to
hear.
Cheers, Ralf
On Fri, Apr 5, 2019 at 9:24 PM Christoph Baumgarten < christoph.baumgarten@gmail.com> wrote:
I created a first draft in a forked repo:
https://github.com/chrisb83/gsod/blob/gsod-stats/2019/SciPy_ideas_list.md
Feedback is welcome! https://github.com/chrisb83/gsod/pull/1
Thanks Chris! Sorry it took a while to get to this. Your content looked good, I added a bit to it in https://github.com/numfocus/gsod/pull/4. I also added a second idea and high level information about the state of SciPy's docs and how we build/develop it. Cheers, Ralf
On Thu, Apr 4, 2019 at 4:43 PM <scipy-dev-request@python.org> wrote:
Send SciPy-Dev mailing list submissions to scipy-dev@python.org
To subscribe or unsubscribe via the World Wide Web, visit https://mail.python.org/mailman/listinfo/scipy-dev or, via email, send a message with subject or body 'help' to scipy-dev-request@python.org
You can reach the person managing the list at scipy-dev-owner@python.org
When replying, please edit your Subject line so it is more specific than "Re: Contents of SciPy-Dev digest..."
Today's Topics:
1. Re: Google Season of Docs (Ralf Gommers) 2. Re: GSoC 2019 Projects (Gregory Lee)
----------------------------------------------------------------------
Message: 1 Date: Thu, 4 Apr 2019 13:26:40 +0200 From: Ralf Gommers <ralf.gommers@gmail.com> To: SciPy Developers List <scipy-dev@python.org> Subject: Re: [SciPy-Dev] Google Season of Docs Message-ID: <CABL7CQg5Qyjb= xf_JMmAOvLamd330m47E1Y356-cLfj99TOXKA@mail.gmail.com> Content-Type: text/plain; charset="utf-8"
On Wed, Apr 3, 2019 at 11:49 PM Paul van Mulbregt < p.vanmulbregt@comcast.net> wrote:
I can be a second mentor for the stats documentation proposal.
Great, thanks Paul!
-Paul
On Apr 3, 2019, at 3:12 PM, Christoph Baumgarten < christoph.baumgarten@gmail.com> wrote:
Sure, I will add it in the next few days.
On Tue, Apr 2, 2019 at 6:02 PM <scipy-dev-request@python.org> wrote:
Send SciPy-Dev mailing list submissions to scipy-dev@python.org
To subscribe or unsubscribe via the World Wide Web, visit https://mail.python.org/mailman/listinfo/scipy-dev or, via email, send a message with subject or body 'help' to scipy-dev-request@python.org
You can reach the person managing the list at scipy-dev-owner@python.org
When replying, please edit your Subject line so it is more specific than "Re: Contents of SciPy-Dev digest..."
Today's Topics:
1. Re: Google Season of Docs (Ralf Gommers)
----------------------------------------------------------------------
Message: 1 Date: Tue, 2 Apr 2019 10:40:20 +0200 From: Ralf Gommers <ralf.gommers@gmail.com> To: SciPy Developers List <scipy-dev@python.org> Subject: Re: [SciPy-Dev] Google Season of Docs Message-ID: <CABL7CQipvttnWrAE= V6Fr+iJKjGM1x0wgKbK-ea7ZNsOXx6YDg@mail.gmail.com> Content-Type: text/plain; charset="utf-8"
On Fri, Mar 22, 2019 at 8:07 PM Ralf Gommers <ralf.gommers@gmail.com> wrote:
On Thu, Mar 21, 2019 at 12:10 PM Christoph Baumgarten < christoph.baumgarten@gmail.com> wrote:
Hi,
taking up Ralf's mail on GSoD, I had a look at the website and
apply.
My project suggestion would be to work on the documentation of a module like stats:
- improve the tutorial site https://docs.scipy.org/doc/scipy/reference/tutorial/stats.html - improve the documentation of the API - check whether current descriptions can be improved - add examples and references - cross-ref to other relevant / similar functions in the module
The second point would require decent knowledge of statistics whereas
propose to the
first point should be easier to tackle for a technical writer. So I see the second point as optional and one could also try to work on the tutorial site of more than one module during the 3-month period.
The task would leave quite a bit of freedom to the writer to choose what areas to focus on, potentially taking up some of the documentation issues that are already on Github.
I could assist as a mentor for stats (we need at least two mentors).
Any suggestions or comments?
Thanks Christoph, this sounds like a good idea to me. We have a lot of content on scipy.stats, and a tech writer could really make a difference in making that easier to understand for users. I suggest we write this up as an idea on our (to be created) ideas page as soon as we know whether we have an umbrella organization that we can participate with.
An update on this: NumFOCUS is applying as an umbrella org. We'll need to add our ideas at https://github.com/numfocus/gsod/blob/master/2019/SciPy_ideas_list.md. Since there are going to be few spots available, it's the quality of the content that matters for acceptance of NumFOCUS as an umbrella org. We should have 1-2 ideas that are well described up on that page by April 14th. There are some guidelines at
https://developers.google.com/season-of-docs/docs/project-ideas#project-idea
Christoph, could you add your idea in that SciPy_ideas_list.md file?
I will add some more general information there about getting started on the SciPy docs. Also, if anyone has another idea, that would be great to
hear.
Cheers, Ralf
participants (2)
-
Christoph Baumgarten -
Ralf Gommers