GSoD 2021 - Statement of Interest
Hello, I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project. I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project. Hope to hear from you soon -- Thank you Mahesh S Nair
Hello, Mahesh Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved! Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs? Cheers, Melissa On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello,
I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy
I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project.
I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project.
Hope to hear from you soon
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
Hi there, The current documentation of NumPy is really good but a bit more improvement can be made to it, which is the prime objective of my project. The improvements which I mentioned in my brief proposal are strategies that can be applied to every documentation to make it better. Apart from general improvements most the documentation related issues in the NumPy's GitHub issue tracker <https://github.com/numpy/numpy/issues?page=2&q=is%3Aissue+is%3Aopen+doc+label%3A%2204+-+Documentation%22> will be addressed. . Some needs more technical information and help from the community. Some are due to the lack of visual aids. Most of them will be addressed and improvements will be made such that similar issues will not be generated in future. Rearranging of sections in the User Guide <https://numpy.org/devdocs/user/absolute_beginners.html> can be done after further discussions Some examples regarding the need of restructuring and duplication are given in the attached document. Apologies in advance if my observations are inaccurate or nitpicks. The given doc is just a very brief one. An in-depth proposal with all the planned changes along with solutions to close as many issues in the tracker will be prepared. I am getting familiar with the community and NumPy. On Thu, Apr 29, 2021 at 9:54 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved!
Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs?
Cheers,
Melissa
On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello,
I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy
I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project.
I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project.
Hope to hear from you soon
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
Hello, Mahesh While you work on this, it may be interesting to keep in mind that we are looking for high-impact work that can be done in the timeframe of the GSoD program - examples would be reorganizing content in a section of the documentation, creating new complete document pages on some subject or concept. It may be worth familiarizing yourself with the documentation (I won't suggest reading all of it as it's huge!) to get an idea for the different sections. One idea would be to focus on the user guide, which contains several sub-pages, and check for improvements that can be done there. Cheers, Melissa On Fri, Apr 30, 2021 at 9:28 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hi there,
The current documentation of NumPy is really good but a bit more improvement can be made to it, which is the prime objective of my project. The improvements which I mentioned in my brief proposal are strategies that can be applied to every documentation to make it better.
Apart from general improvements most the documentation related issues in the NumPy's GitHub issue tracker <https://github.com/numpy/numpy/issues?page=2&q=is%3Aissue+is%3Aopen+doc+label%3A%2204+-+Documentation%22> will be addressed. . Some needs more technical information and help from the community. Some are due to the lack of visual aids. Most of them will be addressed and improvements will be made such that similar issues will not be generated in future. Rearranging of sections in the User Guide <https://numpy.org/devdocs/user/absolute_beginners.html> can be done after further discussions
Some examples regarding the need of restructuring and duplication are given in the attached document. Apologies in advance if my observations are inaccurate or nitpicks. The given doc is just a very brief one. An in-depth proposal with all the planned changes along with solutions to close as many issues in the tracker will be prepared. I am getting familiar with the community and NumPy.
On Thu, Apr 29, 2021 at 9:54 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved!
Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs?
Cheers,
Melissa
On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello,
I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy
I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project.
I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project.
Hope to hear from you soon
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
Hello there Melissa, Thank You for your valuable suggestion.Actually , I am planning for a high-impact work. I have already started reading the User-Guide and working out small projects using NumPy to understand it further, to prepare an in-depth proposal, which will include changes which I mentioned in my brief proposal, reorganizing content, addressing issues in the GitHub tracker and all. One doubt from my side is regarding the timeline. Currently I am planning to prepare the proposal with the GSoD Timeline that is from June 16 2021 and ends on November 16th 2021 with four evaluation phases , Is there any specific timeline from the community or Am I free to follow the same? And as of now, I am planning to set an order in which the tasks needed to be done , which I will share in the first draft of my proposal which I will submit by this week, later changes can be done as per suggestions from the mentors and community. Thank You Mahesh On Sun, May 2, 2021 at 7:05 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
While you work on this, it may be interesting to keep in mind that we are looking for high-impact work that can be done in the timeframe of the GSoD program - examples would be reorganizing content in a section of the documentation, creating new complete document pages on some subject or concept. It may be worth familiarizing yourself with the documentation (I won't suggest reading all of it as it's huge!) to get an idea for the different sections. One idea would be to focus on the user guide, which contains several sub-pages, and check for improvements that can be done there.
Cheers,
Melissa
On Fri, Apr 30, 2021 at 9:28 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hi there,
The current documentation of NumPy is really good but a bit more improvement can be made to it, which is the prime objective of my project. The improvements which I mentioned in my brief proposal are strategies that can be applied to every documentation to make it better.
Apart from general improvements most the documentation related issues in the NumPy's GitHub issue tracker <https://github.com/numpy/numpy/issues?page=2&q=is%3Aissue+is%3Aopen+doc+label%3A%2204+-+Documentation%22> will be addressed. . Some needs more technical information and help from the community. Some are due to the lack of visual aids. Most of them will be addressed and improvements will be made such that similar issues will not be generated in future. Rearranging of sections in the User Guide <https://numpy.org/devdocs/user/absolute_beginners.html> can be done after further discussions
Some examples regarding the need of restructuring and duplication are given in the attached document. Apologies in advance if my observations are inaccurate or nitpicks. The given doc is just a very brief one. An in-depth proposal with all the planned changes along with solutions to close as many issues in the tracker will be prepared. I am getting familiar with the community and NumPy.
On Thu, Apr 29, 2021 at 9:54 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved!
Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs?
Cheers,
Melissa
On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello,
I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy
I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project.
I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project.
Hope to hear from you soon
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
Hello, Mahesh Yes, the timeline looks fine. Cheers, Melissa On Sun, May 2, 2021 at 2:08 PM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello there Melissa,
Thank You for your valuable suggestion.Actually , I am planning for a high-impact work. I have already started reading the User-Guide and working out small projects using NumPy to understand it further, to prepare an in-depth proposal, which will include changes which I mentioned in my brief proposal, reorganizing content, addressing issues in the GitHub tracker and all. One doubt from my side is regarding the timeline. Currently I am planning to prepare the proposal with the GSoD Timeline that is from June 16 2021 and ends on November 16th 2021 with four evaluation phases , Is there any specific timeline from the community or Am I free to follow the same?
And as of now, I am planning to set an order in which the tasks needed to be done , which I will share in the first draft of my proposal which I will submit by this week, later changes can be done as per suggestions from the mentors and community.
Thank You Mahesh
On Sun, May 2, 2021 at 7:05 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
While you work on this, it may be interesting to keep in mind that we are looking for high-impact work that can be done in the timeframe of the GSoD program - examples would be reorganizing content in a section of the documentation, creating new complete document pages on some subject or concept. It may be worth familiarizing yourself with the documentation (I won't suggest reading all of it as it's huge!) to get an idea for the different sections. One idea would be to focus on the user guide, which contains several sub-pages, and check for improvements that can be done there.
Cheers,
Melissa
On Fri, Apr 30, 2021 at 9:28 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hi there,
The current documentation of NumPy is really good but a bit more improvement can be made to it, which is the prime objective of my project. The improvements which I mentioned in my brief proposal are strategies that can be applied to every documentation to make it better.
Apart from general improvements most the documentation related issues in the NumPy's GitHub issue tracker <https://github.com/numpy/numpy/issues?page=2&q=is%3Aissue+is%3Aopen+doc+label%3A%2204+-+Documentation%22> will be addressed. . Some needs more technical information and help from the community. Some are due to the lack of visual aids. Most of them will be addressed and improvements will be made such that similar issues will not be generated in future. Rearranging of sections in the User Guide <https://numpy.org/devdocs/user/absolute_beginners.html> can be done after further discussions
Some examples regarding the need of restructuring and duplication are given in the attached document. Apologies in advance if my observations are inaccurate or nitpicks. The given doc is just a very brief one. An in-depth proposal with all the planned changes along with solutions to close as many issues in the tracker will be prepared. I am getting familiar with the community and NumPy.
On Thu, Apr 29, 2021 at 9:54 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved!
Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs?
Cheers,
Melissa
On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello,
I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy
I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project.
I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project.
Hope to hear from you soon
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
Hi there everyone, I am attaching my in depth proposal for Google Season of Docs 2021 with NumPy along with this mail. Kindly share your thoughts on it Thanks & Regards Mahesh S Nair On Wed, May 5, 2021 at 2:06 AM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Yes, the timeline looks fine.
Cheers,
Melissa
On Sun, May 2, 2021 at 2:08 PM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello there Melissa,
Thank You for your valuable suggestion.Actually , I am planning for a high-impact work. I have already started reading the User-Guide and working out small projects using NumPy to understand it further, to prepare an in-depth proposal, which will include changes which I mentioned in my brief proposal, reorganizing content, addressing issues in the GitHub tracker and all. One doubt from my side is regarding the timeline. Currently I am planning to prepare the proposal with the GSoD Timeline that is from June 16 2021 and ends on November 16th 2021 with four evaluation phases , Is there any specific timeline from the community or Am I free to follow the same?
And as of now, I am planning to set an order in which the tasks needed to be done , which I will share in the first draft of my proposal which I will submit by this week, later changes can be done as per suggestions from the mentors and community.
Thank You Mahesh
On Sun, May 2, 2021 at 7:05 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
While you work on this, it may be interesting to keep in mind that we are looking for high-impact work that can be done in the timeframe of the GSoD program - examples would be reorganizing content in a section of the documentation, creating new complete document pages on some subject or concept. It may be worth familiarizing yourself with the documentation (I won't suggest reading all of it as it's huge!) to get an idea for the different sections. One idea would be to focus on the user guide, which contains several sub-pages, and check for improvements that can be done there.
Cheers,
Melissa
On Fri, Apr 30, 2021 at 9:28 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hi there,
The current documentation of NumPy is really good but a bit more improvement can be made to it, which is the prime objective of my project. The improvements which I mentioned in my brief proposal are strategies that can be applied to every documentation to make it better.
Apart from general improvements most the documentation related issues in the NumPy's GitHub issue tracker <https://github.com/numpy/numpy/issues?page=2&q=is%3Aissue+is%3Aopen+doc+label%3A%2204+-+Documentation%22> will be addressed. . Some needs more technical information and help from the community. Some are due to the lack of visual aids. Most of them will be addressed and improvements will be made such that similar issues will not be generated in future. Rearranging of sections in the User Guide <https://numpy.org/devdocs/user/absolute_beginners.html> can be done after further discussions
Some examples regarding the need of restructuring and duplication are given in the attached document. Apologies in advance if my observations are inaccurate or nitpicks. The given doc is just a very brief one. An in-depth proposal with all the planned changes along with solutions to close as many issues in the tracker will be prepared. I am getting familiar with the community and NumPy.
On Thu, Apr 29, 2021 at 9:54 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved!
Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs?
Cheers,
Melissa
On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello,
I am Mahesh from India. I am interested in doing Google Season of Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS - NumPy
I have past experience in documentation writing with WordPress and have completed *Google Summer of Code 2018 *with KDE. I have been an open source enthusiast and contributor since 2017.My past experience with coding ,code documentation , understanding code bases ,will help achieve this task without much input from your end. I have about four years experience working with Open-Source and currently working as a *Quality Assurance specialis*t . I have delivered technical talks at international conferences (KDE-Akademy) and was *mentor of Google Code-In* also. All these makes me the best candidate for the project.
I am attaching a brief proposal for the work along with this mail. A more in-depth A more in depth proposal with timelines , all planned strategies , document structures will be submitted after more discussion with the mentors and community. I am ready to start the work as soon as possible and will be able work 7 to 9 hours per day including weekends. I strongly wish to be part of the NumPy community even after the project.
Hope to hear from you soon
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
Hello, Mahesh! We will take your project into consideration and let you know of our decision shortly. Cheers! Melissa On Sat, May 8, 2021 at 4:19 PM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hi there everyone,
I am attaching my in depth proposal for Google Season of Docs 2021 with NumPy along with this mail. Kindly share your thoughts on it
Thanks & Regards Mahesh S Nair
On Wed, May 5, 2021 at 2:06 AM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Yes, the timeline looks fine.
Cheers,
Melissa
On Sun, May 2, 2021 at 2:08 PM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hello there Melissa,
Thank You for your valuable suggestion.Actually , I am planning for a high-impact work. I have already started reading the User-Guide and working out small projects using NumPy to understand it further, to prepare an in-depth proposal, which will include changes which I mentioned in my brief proposal, reorganizing content, addressing issues in the GitHub tracker and all. One doubt from my side is regarding the timeline. Currently I am planning to prepare the proposal with the GSoD Timeline that is from June 16 2021 and ends on November 16th 2021 with four evaluation phases , Is there any specific timeline from the community or Am I free to follow the same?
And as of now, I am planning to set an order in which the tasks needed to be done , which I will share in the first draft of my proposal which I will submit by this week, later changes can be done as per suggestions from the mentors and community.
Thank You Mahesh
On Sun, May 2, 2021 at 7:05 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
While you work on this, it may be interesting to keep in mind that we are looking for high-impact work that can be done in the timeframe of the GSoD program - examples would be reorganizing content in a section of the documentation, creating new complete document pages on some subject or concept. It may be worth familiarizing yourself with the documentation (I won't suggest reading all of it as it's huge!) to get an idea for the different sections. One idea would be to focus on the user guide, which contains several sub-pages, and check for improvements that can be done there.
Cheers,
Melissa
On Fri, Apr 30, 2021 at 9:28 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
Hi there,
The current documentation of NumPy is really good but a bit more improvement can be made to it, which is the prime objective of my project. The improvements which I mentioned in my brief proposal are strategies that can be applied to every documentation to make it better.
Apart from general improvements most the documentation related issues in the NumPy's GitHub issue tracker <https://github.com/numpy/numpy/issues?page=2&q=is%3Aissue+is%3Aopen+doc+label%3A%2204+-+Documentation%22> will be addressed. . Some needs more technical information and help from the community. Some are due to the lack of visual aids. Most of them will be addressed and improvements will be made such that similar issues will not be generated in future. Rearranging of sections in the User Guide <https://numpy.org/devdocs/user/absolute_beginners.html> can be done after further discussions
Some examples regarding the need of restructuring and duplication are given in the attached document. Apologies in advance if my observations are inaccurate or nitpicks. The given doc is just a very brief one. An in-depth proposal with all the planned changes along with solutions to close as many issues in the tracker will be prepared. I am getting familiar with the community and NumPy.
On Thu, Apr 29, 2021 at 9:54 PM Melissa Mendonça <melissawm@gmail.com> wrote:
Hello, Mahesh
Thank you for your proposal. One thing I would say is that some of the things you are suggesting are already there - for example, the How-tos and Explanations section - but I agree they can be improved!
Another question I could pose is about duplication of content: can you give examples of duplicated content that you found in the docs?
Cheers,
Melissa
On Wed, Apr 28, 2021 at 12:33 AM Mahesh S <mahesh6947foss@gmail.com> wrote:
> Hello, > > I am Mahesh from India. I am interested in doing Google Season of > Docs with NumPy on the project HIGH-LEVEL RESTRUCTURING AND END-USER FOCUS > - NumPy > > I have past experience in documentation writing with WordPress and > have completed *Google Summer of Code 2018 *with KDE. I have been > an open source enthusiast and contributor since 2017.My past experience > with coding ,code documentation , understanding code bases ,will help > achieve this task without much input from your end. I have about four years > experience working with Open-Source and currently working as a *Quality > Assurance specialis*t . I have delivered technical talks at > international conferences (KDE-Akademy) and was *mentor of Google > Code-In* also. All these makes me the best candidate for the > project. > > I am attaching a brief proposal for the work along with this mail. A > more in-depth A more in depth proposal with timelines , all planned > strategies , document structures will be submitted after more discussion > with the mentors and community. > I am ready to start the work as soon as possible and will be able > work 7 to 9 hours per day including weekends. I strongly wish to be part of > the NumPy community even after the project. > > > Hope to hear from you soon > > -- > Thank you > Mahesh S Nair > > _______________________________________________ > NumPy-Discussion mailing list > NumPy-Discussion@python.org > https://mail.python.org/mailman/listinfo/numpy-discussion > _______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
-- Thank you Mahesh S Nair
_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion
participants (2)
-
Mahesh S -
Melissa Mendonça