While everyone struggles , I chose to embrace the struggle.
Hello everyone, I am here again with the 2nd Blog of my journey as an Outreachy intern. For those who don’t know me , I am Neelima Mohanty , selected as an Outreachy intern at Humanitarian OpenStreetMap Team (HOTOSM) for the May to August Cohort. If you are new to my blog then make sure you read my Blog 1 before going through this blog post.
How many of you have come across new terms while contributing to open source communities? I guess everyone has . And do you remember how did you cope with it? As you think of all this , I will narrate you one such experience of mine during the contribution phase of Outreachy during March 2023 .
While raising a PR to add comments to the code of the osm-fieldwork repo as part of technical documentation , my mentor Rob Savoye reviewed it and said me that he liked the thought of adding comments to the code but it was not the right way. I would like to quote his words “Thanks for adding comments. We usually don’t need to comment write() and open(), as it’s obvious. If you want to get really deep into commenting source code, we want to add support for sphinx.This adds a comment block for each class and method. This would require you read and gain some understanding of the code itself, which is not a bad thing. We use sphinx for other python projects.”


