publiclab / plots2

a collaborative knowledge-exchange platform in Rails; we welcome first-time contributors! :balloon:
https://publiclab.org
GNU General Public License v3.0
958 stars 1.83k forks source link

Convening teams + planning issues for Outreachy/Summer of Code #5684

Closed jywarren closed 5 years ago

jywarren commented 5 years ago

Hi, all! We have some more guidance coming for folks in our summer programs #5667 -- but I also want to encourage people to begin getting to know one another, and looking at who will be working together this summer.

Some of you are pretty much on a team together on one project, like @alaxalves and @kaustubh-nair -- although how you share the work needs to be planned out -- and others will be working on parts that link up with each other, like @ananyaarun and @CleverFool77 and @gautamig54, for one example (@ananyaarun's work on maps will be featured on several of the pages on PublicLab.org the others will be working on!)

So, this kind of thing needs some discussion, planning, and coordination. Please consider starting to transfer your proposal tasks into "planning issues" with checklists, as outlined in the "Modularity" blog post on https://publiclab.org/software-outreach -- and people can start to organize tasks among team members in such planning issues.

Some working in parallel may be necessary and helpful! Someone could work on the front-end, while someone else works on the controllers. Or one person could develop re-usable templates that the other plugs into overall page designs! Our UI teams have some to digest in our new Style Guide draft!

@CleverFool77 @ananyaarun @IshaGupta18 @namangupta01 @sidntrivedi012 @divyabaid16 @Divy123 @MargaretAN9 @ViditChitkara @aashna27 @gautamig54 @kaustubh-nair @rexagod @alaxalves

Mentors - I've assigned people more projects, just because I hadn't heard from everyone. I'm happy to change, add, reduce your projects, so please feel free to contact me; we can use the 'reviewers' Gitter room to coordinate. I'm sorry if you got lots of notifications, i don't mean to imply you /have/ to take on more projects, just wanted to get the ball rolling, and we can readjust now. Thanks! πŸ™Œ

Mentors so far: @jainaman224 @ebarry @sagarpreet-chadha @Harshithpabbati @siaw23 @Souravirus @gauravano @Mridul97 @sashadev-sky @SidharthBansal

jywarren commented 5 years ago

And noting I've just added everyone above to @publiclab/soc - mentors and participants -- and will soon create the mentors list too!

Update: done -- for reviews, please see @publiclab/reviewers, but if you really need /just/ mentors, you can now use @publiclab/mentors. Thank you!

SidharthBansal commented 5 years ago

Thanks Jeff. Let's plan things out.

SidharthBansal commented 5 years ago

Hi @publiclab/soc team, all the participants are requested to open Planning issues like we did last summer. For one project we can open up one planning issue. Example for MK Rails Upgrade we will have one planning issue in the MK repository where @kaustubh-nair and @alaxalves will coordinate. We can follow this approach for all the projects. Like Naman and Gautami for Notification System Naman and Isha for the Sensor Data Project Vidit and @divyabaid16 for MK synchronous editing project and so on. We can use the assign feature at the planning issue for assigning all the mentors and all the participants on those issues. This will make us work highly managable and modular. In case we will create gitter rooms then there are people who uses other IRC channel which does not provide ability to save the previous messages. This can create problem. So i think best approach will be to create planning issues which we did each year.

kaustubh-nair commented 5 years ago

Sounds awesome. @alaxalves and I will have a discussion over the weekend and put up the schedule and division of work on the planning issue accordingly.

SidharthBansal commented 5 years ago

That will be simply awesome!!! You can discuss and interact at the planning issue. Update the header of the issue as you progress through out the project

SidharthBansal commented 5 years ago

@publiclab/soc also, we used the Milestones. Milestones are used to acertain the progress of the project. So, please add all your issues/prs/ftos into the milestone so that we can evaluate your progress by just reading the milestones. You can use gsoc or outreachy label on the issues and prs. Don't forget to break the planning issue into individual issues and link them to the main planning issue Thanks

SidharthBansal commented 5 years ago

https://github.com/publiclab/plots2/issues/2676 and https://github.com/publiclab/plots2/issues/2388 can help you folks for understanding how we do planning issues at pl. Thanks

CleverFool77 commented 5 years ago

Hi @jywarren and @SidharthBansal I had a question. Me and @gautamig54 will be working on UI. So Should I open an issue containing all the division of works in checklists where we will look into the matter regarding coordination ?

sagarpreet-chadha commented 5 years ago

Hi @CleverFool77 , Yes please go ahead . I also did the same during my gsoc :) https://github.com/publiclab/plots2/issues/2671

asquare14 commented 5 years ago

May I suggest using the Projects feature in GitHub. Issues directly move from Todo to done as soon as it is closed, and you can move them to work in progress too. I think it'll help to keep track of issues more efficiently. Let me know if you need help setting it up. :) Here's an example project that my mentors set up during RGSoC for me https://github.com/ifmeorg/ifme/projects/10

On Fri, May 10, 2019, 3:50 PM Sagarpreet Chadha notifications@github.com wrote:

Hi @CleverFool77 https://github.com/CleverFool77 , Yes please go ahead . I also did the same during my gsoc :) #2671 https://github.com/publiclab/plots2/issues/2671

β€” You are receiving this because you are on a team that was mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491239616, or mute the thread https://github.com/notifications/unsubscribe-auth/AFPAIVO3THUCW2GPXLUL3KLPUVEAHANCNFSM4HLR7LAQ .

SidharthBansal commented 5 years ago

@aSquare14 thanks for the suggestion. I think that feature requires things to be given by mentors. We need to give rights to create projects to the students if we want them to be listed under projects. @jywarren what you think is better option Milestones/Projects?

asquare14 commented 5 years ago

If I'm not wrong I think anyone can create a project as long as they're added to the org :)

On Fri, May 10, 2019, 6:40 PM Sidharth Bansal notifications@github.com wrote:

@aSquare14 https://github.com/aSquare14 thanks for the suggestion. I think that feature requires things to be given by mentors. We need to give rights to create projects to the students if we want them to be listed under projects. @jywarren https://github.com/jywarren what you think is better option Milestones/Projects?

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491283171, or mute the thread https://github.com/notifications/unsubscribe-auth/AFPAIVJ3EEWPF6SCP4W7ZULPUVX4XANCNFSM4HLR7LAQ .

SidharthBansal commented 5 years ago

What is difference between milestones and project? Can you please indicate advantages and disadvantages for both? Thanks

On Fri, May 10, 2019, 7:33 PM Atibhi Agrawal notifications@github.com wrote:

If I'm not wrong I think anyone can create a project as long as they're added to the org :)

On Fri, May 10, 2019, 6:40 PM Sidharth Bansal notifications@github.com wrote:

@aSquare14 https://github.com/aSquare14 thanks for the suggestion. I think that feature requires things to be given by mentors. We need to give rights to create projects to the students if we want them to be listed under projects. @jywarren https://github.com/jywarren what you think is better option Milestones/Projects?

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <https://github.com/publiclab/plots2/issues/5684#issuecomment-491283171 , or mute the thread < https://github.com/notifications/unsubscribe-auth/AFPAIVJ3EEWPF6SCP4W7ZULPUVX4XANCNFSM4HLR7LAQ

.

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491300102, or mute the thread https://github.com/notifications/unsubscribe-auth/AFAAEQ4R6UQD4OTYN3SRZULPUV6BRANCNFSM4HLR7LAQ .

asquare14 commented 5 years ago

@SidharthBansal Found this great answer on stackoverflow ! Do give it a read https://stackoverflow.com/questions/39591795/what-is-the-difference-relationship-between-github-projects-and-milestones

SidharthBansal commented 5 years ago

Awesome!!! I think projects is a better option.

On Fri, May 10, 2019 at 9:21 PM Atibhi Agrawal notifications@github.com wrote:

@SidharthBansal https://github.com/SidharthBansal Found this great answer on stackoverflow ! Do give it a read https://stackoverflow.com/questions/39591795/what-is-the-difference-relationship-between-github-projects-and-milestones

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491337540, or mute the thread https://github.com/notifications/unsubscribe-auth/AFAAEQ2ZPACT5ODUDWISOLDPUWKXXANCNFSM4HLR7LAQ .

grvsachdeva commented 5 years ago

Yeah, using GitHub projects is a better option. We already have many projects - https://github.com/publiclab/plots2/projects :smiley:.

CleverFool77 commented 5 years ago

Hi everyone. So Should I create project under the name Outreachy 2019, In which I'll open various tasks like people section , questions section etc ?

grvsachdeva commented 5 years ago

Hi, please use name relevant to project like UI redesign , etc

Gaurav Sachdeva

On Sat 11 May, 2019, 3:54 PM Lekhika Dugtal, notifications@github.com wrote:

Hi everyone. So Should I create project under the name Outreachy 2019, In which I'll open various tasks like people section , questions section etc ?

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491499036, or mute the thread https://github.com/notifications/unsubscribe-auth/AE7JF5QRMAPALODKH2Y5HBDPU2NEPANCNFSM4HLR7LAQ .

gautamig54 commented 5 years ago

@CleverFool77 The idea sounds great. You can open issue saying "UI improvements - Summer 2019" or something like this and we can start the discussions and divide the work for different webpages. @namangupta01, I can open an issue for "Notification System" and start the discussion and divide the work accordingly. Thanks!

SidharthBansal commented 5 years ago

Go ahead Gautami

On Sat, May 11, 2019, 5:43 PM Gautami Gupta notifications@github.com wrote:

@CleverFool77 https://github.com/CleverFool77 The idea sounds great. You can open issue saying "UI improvements - Summer 2019" or something like this and we can start the discussions and divide the work for different webpages. @namangupta01 https://github.com/namangupta01, we can open a project for "Notification System" and start the discussion and divide the work accordingly.

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491506022, or mute the thread https://github.com/notifications/unsubscribe-auth/AFAAEQ3XL2AFSSE65R5HBGTPU2Z6VANCNFSM4HLR7LAQ .

CleverFool77 commented 5 years ago

Hi @gautamig54 and everyone I just opened the project for UI improvements. Now all the new cards and checklists will be added there. @gautamig54 I guess we can start off with our checklists. Now all the issues for UI improvements in summer of code would added there. How do we divide them ? Should I divide the whole project into sections of people, question, dashboard , tags etc. And every section into further todos parts? It would be great to hear some suggestions regarding the protocol followed in projects as I never used one before. Thank You.

SidharthBansal commented 5 years ago

Best way to do things is without restriction in the way you wish to do. Once different teams are set up, teams can look in each others team and find good portions which they can adopt. This approach will give us a quick start with great future enhancements.

On Sat, May 11, 2019, 9:59 PM Lekhika Dugtal notifications@github.com wrote:

Hi @gautamig54 https://github.com/gautamig54 and everyone I just opened the project for UI improvements. Now all the new cards and checklists will be added there. @gautamig54 https://github.com/gautamig54 I guess we can start off with our checklists. How do we divide them ? Should I divide the whole project into sections of people, question, dashboard , tags etc. And every section into further todos parts? It would be great to hear some suggestions regarding the protocol followed in projects as I never used one before. Thank You.

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491525256, or mute the thread https://github.com/notifications/unsubscribe-auth/AFAAEQ6YKRSFABHMLJDZCTTPU3X7JANCNFSM4HLR7LAQ .

namangupta01 commented 5 years ago

Ya sure Gautami, Can we discuss after 16 may? I have my exams going on. Thanks!!

On Sat, May 11, 2019 at 5:43 PM Gautami Gupta notifications@github.com wrote:

@CleverFool77 https://github.com/CleverFool77 The idea sounds great. You can open issue saying "UI improvements - Summer 2019" or something like this and we can start the discussions and divide the work for different webpages. @namangupta01 https://github.com/namangupta01, we can open a project for "Notification System" and start the discussion and divide the work accordingly.

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684#issuecomment-491506022, or mute the thread https://github.com/notifications/unsubscribe-auth/AE6AEYP7YODAMCTJHTY6O73PU2Z6VANCNFSM4HLR7LAQ .

SidharthBansal commented 5 years ago

Best Of Luck Naman.

SidharthBansal commented 5 years ago

Please link milestone/projects/planning issues here.

SidharthBansal commented 5 years ago

https://github.com/publiclab/mapknitter/issues/305

SidharthBansal commented 5 years ago

https://github.com/publiclab/mapknitter/issues/593 @divyabaid16 @vidit here is issue for you. You asked me to open for you. Please feel free to make it as per your project requirements. Best of luck

sidntrivedi012 commented 5 years ago

@jywarren @SidharthBansal Opened the Planning issue in Spectral-workbench.js for the Spectral Workbench Capture project. Please review. https://github.com/publiclab/spectral-workbench.js/issues/92

I will be adding more sub-tasks in a detailed format to the issue shortly. I am currently somewhat busy due to my university exams which will be ending on 22nd May. Though, I will try to keep up with the work to be done and going on here.

Thanks :slightly_smiling_face:

SidharthBansal commented 5 years ago

Awesome!!! Best of luck to you all!!! I have my exams till 19th(on Sunday too!!!). My university wants us to study even at weekends.. lol...hahaha

jywarren commented 5 years ago

This is looking great, folks! I've been trying to go in and give deeper comments on each project's planning issues every couple days. I just did this here: https://github.com/publiclab/leaflet-environmental-layers/issues/168

Actually i'm noticing that there are a lot of projects this year which will be getting started in a separate repo outside plots2 but with the intention of re-integrating later. This is cool and it's a great approach. I've started trying to connect folks who are working in this way. I know @IshaGupta18 @namangupta01 have just gone through this process quite quickly! This may be relevant to @Rishabh570 as well, in terms of how to architect a stand-alone JS library.

Note that folks like @gautamig54 @CleverFool77 don't need to do this - your work will be right in plots2. But for those working on satellite libraries or general purpose libraries or like @sidntrivedi012 or @rexagod on a satellite library to another codebase, you can rely on each other a lot for guidance and ideas and helpful critique on how to structure your projects.

Awesome to see everyone getting organized and ready! πŸŽ‰ πŸŽ‰ πŸŽ‰

gautamig54 commented 5 years ago

@CleverFool77 Thanks for opening a project for UI improvements. I think it is better to have a separate issue for each page which can be added in the to-do list for the project. Also, I will open up an issue which will list down the pages which we need to focus on or any other UI improvements and we can discuss our summer plan there. It will be helpful for an organised start to the project as our entire summer plan will be at a single place.

jywarren commented 5 years ago

Gautami this sounds super!

On Thu, May 16, 2019 at 7:07 PM Gautami Gupta notifications@github.com wrote:

@CleverFool77 https://github.com/CleverFool77 Thanks for opening a project for UI improvements. I think it is better to have a separate issue for each page which can be added in the to-do list for the project. Also, I will open up an issue which will list down the pages which we need to focus on or any other UI improvements and we can discuss our summer plan there. It will be helpful for an organised start to the project as our entire summer plan will be at a single place.

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684?email_source=notifications&email_token=AAAF6J56YWJUPJSUDDPEFS3PVXSILA5CNFSM4HLR7LA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODVTJASI#issuecomment-493260873, or mute the thread https://github.com/notifications/unsubscribe-auth/AAAF6J4J3CHNAZ3KRY2WJYTPVXSILANCNFSM4HLR7LAQ .

gautamig54 commented 5 years ago

I have opened a project for the Notification System. @namangupta01 Can you have a look at it and add if I missed something. Also, should I create an issue for the Notification System project for discussions?

SidharthBansal commented 5 years ago

We can have discussion in the planning issue itself. At the beginning of issue, you can have the editable checklist. Thanks

On Fri, May 17, 2019, 4:50 AM Gautami Gupta notifications@github.com wrote:

I have opened a project for the Notification System. @namangupta01 https://github.com/namangupta01 Can you have a look at it and add if I missed something. Also, should I create an issue for the Notification System project for discussions?

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684?email_source=notifications&email_token=AFAAEQ6GJOI6FEM3PFD76GLPVXT33A5CNFSM4HLR7LA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODVTJVFQ#issuecomment-493263510, or mute the thread https://github.com/notifications/unsubscribe-auth/AFAAEQZS3PL6KTR55UWMWYDPVXT33ANCNFSM4HLR7LAQ .

Divy123 commented 5 years ago

@aashna27 , @publiclab/mentors I have added the project for Image Sequencer here: https://github.com/publiclab/image-sequencer/projects/2 Aashna you can add your set of issues as well by breaking them up as suitable for you. Also we can collaborate upon and keep on breaking some issues as suitable.

CleverFool77 commented 5 years ago

@CleverFool77 Thanks for opening a project for UI improvements. I think it is better to have a separate issue for each page which can be added in the to-do list for the project. Also, I will open up an issue which will list down the pages which we need to focus on or any other UI improvements and we can discuss our summer plan there. It will be helpful for an organised start to the project as our entire summer plan will be at a single place.

Hi @gautamig54 . That's exactly what I followed. I tried keeping different issue for each section. And In each section , I added further checklists based on division of work. We'll be adding these issues in todos of projects. It would make the process convenient and easy Thanks !!!

namangupta01 commented 5 years ago

Hi @gautamig54, I have added some tasks in the project and will add some soon.

SidharthBansal commented 5 years ago

Great

On Sat, May 18, 2019, 1:05 AM Naman Gupta notifications@github.com wrote:

Hi @gautamig54 https://github.com/gautamig54, I have added some tasks in the project and will add some soon.

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684?email_source=notifications&email_token=AFAAEQYZ474ILF5PPR4HD73PV4CINA5CNFSM4HLR7LA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODVVVOYA#issuecomment-493573984, or mute the thread https://github.com/notifications/unsubscribe-auth/AFAAEQ3ZQSKUL3CXYUVUSELPV4CINANCNFSM4HLR7LAQ .

asquare14 commented 5 years ago

@SidharthBansal Can you please add me to the reviewers chat on gitter so that I can discuss a few things with you all ! :)

jywarren commented 5 years ago

Just noting this, sorry for slow reply -- the reviewers room is at https://gitter.im/publiclab/reviewers ! I believe it's public!

On Wed, May 22, 2019 at 1:04 AM Atibhi Agrawal notifications@github.com wrote:

@SidharthBansal https://github.com/SidharthBansal Can you please add me to the reviewers chat on gitter so that I can discuss a few things with you all ! :)

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684?email_source=notifications&email_token=AAAF6J2DVYC2JWP3RMDB7FTPWTH4JA5CNFSM4HLR7LA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODV547CQ#issuecomment-494653322, or mute the thread https://github.com/notifications/unsubscribe-auth/AAAF6JYH46URLQCGLO36XVLPWTH4JANCNFSM4HLR7LAQ .

grvsachdeva commented 5 years ago

@jywarren actually the reviewers' group is an invite-only group. I just added you @aSquare14 to the group. Welcome :tada: !!

asquare14 commented 5 years ago

Thanks.

On Wed, May 29, 2019, 2:15 AM Gaurav Sachdeva notifications@github.com wrote:

@jywarren https://github.com/jywarren actually the reviewers' group is an invite-only group. I just added you @aSquare14 https://github.com/aSquare14 to the group. Welcome πŸŽ‰ !!

β€” You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/publiclab/plots2/issues/5684?email_source=notifications&email_token=AFPAIVL7P7ULB5M4GBBWQ4TPXWKXHA5CNFSM4HLR7LA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODWNMNGI#issuecomment-496682649, or mute the thread https://github.com/notifications/unsubscribe-auth/AFPAIVOCVMW4JR3SS54HHHTPXWKXHANCNFSM4HLR7LAQ .

jywarren commented 5 years ago

Great work everyone!!!!