search

commons-app / apps-android-commons

The Wikimedia Commons Android app allows users to upload pictures from their Android phone/tablet to Wikimedia Commons
https://commons-app.github.io/
Apache License 2.0
1.01k stars 1.19k forks source link

Selection of topics for Vienna hackathon and Prague pre-hackathon #353

Closed misaochan closed 7 years ago

misaochan commented 7 years ago

As the events are drawing nearer, I am attempting to consolidate the suggestions offered at #293 so that we can make a decision. The Prague pre-hackathon, based on my discussions with @VojtechDostal, would involve an introduction to the app to familiarize people with the codebase, and a small task related to the Nearby function. The Vienna hackathon would likely involve a larger task and would also provide an opportunity to collaborate with other WMF folks (e.g. newcomers, or the Wikipedia app devs) if needed.

Potential tasks, in my opinion, based on suggestions received:

Pre-hackathon:

Hackathon:

Thoughts?

misaochan commented 7 years ago

Once we have decided on our project for the hackathon, we will need to add it to https://phabricator.wikimedia.org/project/board/2530/ I believe.

Abbe98 commented 7 years ago

As author of the Articles by lat/lon without Images API I'm pinging in myself :-)

misaochan commented 7 years ago

Awesome, see you there @Abbe98 :)

misaochan commented 7 years ago

Received advice from Rachel Farrand via email:

Besides creating the Phabricator task as you say (you will be surprised at how many people actually see these), a small number of people who want progress or help in advance of hackathons choose to email their project to the wikitech-l mailing list to get even more visibility and help. That is totally up to you. :) Also, at the opening of hackathon itself all participants will get the opportunity to announce what they are working on and what help (if any) they need for their projects.

If you are looking to run an hour long session (for example something like "Brainstorming Session on Improving the Wikimedia Commons App" or "Wikimedia Commons App: What we have now and where to go next" or whatever) at the hackathon in one of the breakout rooms instructions on how to schedule those will be posted much closer to the event as well. You don't have to worry about being able to get a space during the event, we wont run out of space for you.

If there are any WMF developers that you want to coordinate with in advance of the event I am also happy to introduce you by email or if you like I can check and see which WMF mobile devs will be attending.

Just let me and Srishti know what you need in order for your projects to be successful and we will do our best to help!

I think the hour-long brainstorming session that she mentioned would be a good addition to our plans, especially as it is an opportunity to get feedback from a wide range of fellow developers.

Are there any WMF devs in particular whom we would like to invite/request for collaboration during the event?

tobias47n9e commented 7 years ago

I created a task for the discussion: https://phabricator.wikimedia.org/T158994 A task for the image request / campaign request project: https://phabricator.wikimedia.org/T158995 And a task for the Django/MW-OAuth intro: https://phabricator.wikimedia.org/T158998

@misaochan Can you create the project taks for the Android app?

Edit: And I am not sure if we should create a project or tasks for the hackathon in Prag? Probably up to the local community if they want to organize the event with phabricator?

misaochan commented 7 years ago

Hi @tobias47n9e ,

Just clarifying how this works: We want to create a Phab task for each task that we plan on working on for the hackathon, right? But what if we haven't decided exactly which task to work on? I think doing all of the tasks that I listed above is a bit too much, even if they are split between the pre-hackathon and hackathon. But I'm hoping to get more feedback from folks who are interested before we settle on the final task(s).

Or can I just start one general "task" for our app and list the possible projects within that task?

Tagging @VojtechDostal to ask about how WMCZ would like the prehackathon to be organized.

VojtechDostal commented 7 years ago

Hi all! Thanks for working on this. From my perspective it would be best to list all possible tasks we might work on and prioritize those. We may decide to work on some of these in the weeks before the events, while additional decisions can be made during the events themselves.

WMCZ will mostly be behind logistics of both events and won't decide which tasks are "appropriate" and which are not. Our incentive is to improve the "Nearby" function and add Wikidata as a source for those data but generally we'll support all that sounds reasonable and is within the scope of the Wikimedia Commons app :-)

tobias47n9e commented 7 years ago

I would say we create task in "Projects" (https://phabricator.wikimedia.org/project/board/2530/) to show people that they can work on this project during the hackathon. They can also join our discussion session. We could also add one item in skill share if we want to show novice developers how they can tackle and issue with the app. I think we should stick with Github for subtasks, as it would only duplicate a lot of discussions.

misaochan commented 7 years ago

@tobias47n9e done. :)

What do you think the length of a skill share session should be, and how should it be structured? Maybe fixing a minor bug, so a couple hours all around including introduction and helping them set up the development environment?

tobias47n9e commented 7 years ago

@misaochan I think that is up to you and the other Android developers. Maybe two people could do one hour each, so they don't exhaust themselves with explaining stuff :)

Setting up the development environment and how to debug and issue sounds good. Probably most people in the room will afterwords already know how to tackle an easy issue.

whym commented 7 years ago

How about asking participants to try setting up the developing environment at home? If they can successfully install Android Studio etc at home, that's great. Even if it's only partially done, it could save some waiting time (e.g. for downloading things) at the hackathon.

Also, is there a way to know the level of familiarity to Android/Java/GitHub of the participants, perhaps by asking at the online registration or in a follow up email? Knowing that would help planning things.

nicolas-raoul commented 7 years ago

Just to say that I agree: When doing trainings it is easy to lose a lot of time with silly things like Wi-Fi connection or environment problems, so indeed I would recommend to ask participants to kindly:

On Tue, Feb 28, 2017 at 6:48 PM, Yusuke Matsubara notifications@github.com wrote:

How about asking participants to try setting up the developing environment at home? If they can successfully install Android Studio etc at home, that's great. Even if it's only partially done, it could save some waiting time (e.g. for downloading things) at the hackathon.

Also, is there a way to know the level of familiarity to Android/Java of the participants, perhaps by asking at the online registration or in a follow up email? That would help planning things.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/commons-app/apps-android-commons/issues/353#issuecomment-282992691, or mute the thread https://github.com/notifications/unsubscribe-auth/AAGFBgOab9pvthf0oVw0IBsZkuRIlMraks5rg-1ygaJpZM4L-2nP .

VojtechDostal commented 7 years ago

@whym We will ask about level of familiarity to Android/Java/GitHub in a registration form that we plan to send out with @misaochan in a few days. Thanks for comments all!

misaochan commented 7 years ago

Good idea, I'll add those requests to the pre-hackathon wiki page. Shall I also add them to the Phab task for our project in the hackathon, or will we also have a page for that?

misaochan commented 7 years ago

Added to the pre-hackathon wiki, do let me know if I missed anything.

misaochan commented 7 years ago

Registration and scholarship applications are open! Apply here.

Tagging those who have made contributions in the past: @whym @domdomegg @veyndan @tobias47n9e @anirudh24seven @AtaZh @jayvdb . Please feel free to tag anyone else whom you think might be interested, thanks!

domdomegg commented 7 years ago

Greatly appreciate the offer but unfortunately I'm busy then

asadsalman commented 7 years ago

Do you guys think it would be better to have topics that people can work on during both the pre-hackathon and the main hackathon event? Or should the work done at both events be kept separate?

Moreover, are you guys looking to have "Skill Shares" like the main event has?

misaochan commented 7 years ago

@asadsalman I think it might be a good idea to have one task for the pre-hackathon and another task for the hackathon initially, and see how it goes. If the pre-hackathon task finishes early then we can start on the hackathon task and add more to the list, or if it doesn't finish in time then we can continue during the hackathon? What do the others think?

Could you elaborate on the "Skill Share" sessions please? From what I'm seeing, they look like tutorials/introductory sessions? In that case, if there are newbies present at the pre-hackathon, I will probably run one during the first day to get everyone up to speed - just a basic introduction on the app, how it works, how to build, etc. Also, anyone with a specific niche is welcome to conduct a session. :) I think @tobias47n9e has offered to do a short intro on the web app, for one.

maskaravivek commented 7 years ago

The idea of having some sort of a "Skill share" session definitely seems good. If we are doing some form of a short intro web app we can decide up on the tasks and I would love to do some work in setting it up. @tobias47n9e

I would also love to volunteer in helping the newbies setup things as mentioned by @nicolas-raoul at the start of the pre-hackathon.

tobias47n9e commented 7 years ago

I just wanted to say that we should ensure that all of the things we do during the hackathon are also documented here for those that can't attend. Although there is budget for some people to attend it will most likely impossible to invite everyone (for those that still are active next year we can probably figure out a scholarship rotation).

I already finished my skill-share tutorial here: https://wikitech.wikimedia.org/wiki/Help:Tool_Labs/My_first_Django_OAuth_tool So if anyone wants to go through the steps and see what can be improved they are very welcome.

domdomegg commented 7 years ago

Do you think it might be possible to record some of it, especially the introductory sessions? Doesn't have to be very high quality just a phone strapped to a makeshift tripod + a half-decent microphone would probably be good enough.

Akanksha08 commented 7 years ago

Hello folks! I am really interested in participating in the pre hackathon as well as the hackathon. I am done with the pre preparation mentioned here: https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2017/Prehackathon_Prague

Please guide me how do I proceed. I would like to get some hands on before I attend the actual hackathon.

misaochan commented 7 years ago

I think we will probably have to ask @VojtechDostal about the logistics, as I'm not sure what recording etc facilities are available. Also, will we want slides for the introductory session? I figure they would be easier for people to refer to, and I'd be happy to make them, but will there be a projector in the room that we can use?

@Akanksha08 welcome! :) Please take a look through our Issues section, especially those tagged beginner-friendly. Now that you have set up the dev environment and built the project, the best way to learn IMO is to try to tackle a small issue. If you encounter any problems or can't find an issue that you are interested in working on, please let us know.

misaochan commented 7 years ago

Potential plans in a bit more detail. Please let me know what you think, there is still plenty of time to discuss and modify.

Pre-hackathon:

Hackathon:

niedzielski commented 7 years ago

Sorry for the ultra slow response :] I won't be at the hackathon unfortunately but @dbrant and @mdholloway might. I can probably also do a Hangout if that would be useful.

dbrant commented 7 years ago

@misaochan I will be at the hackathon, and will likely have some bandwidth to help with this, either in the form of actual hacking or product/technical guidance.

misaochan commented 7 years ago

Thanks guys! :) @dbrant that would be great, thank you. Shall we arrange a time with you closer to the date of the hackathon, or would you like to just drop by?

dbrant commented 7 years ago

Sure, it would probably make sense to meet briefly before the hackathon to solidify how I can be of service. (or just discuss it on the phab task)

misaochan commented 7 years ago

I've taken the liberty of setting up a rough programme structure for the prehackathon based on discussion with @VojtechDostal . If I'm missing anything or anyone disagrees with anything, please let me know.

misaochan commented 7 years ago

@whym - If I understand correctly, you will be attending, yeah? Would you like to talk briefly about the Commons app stats tool that you have created?

whym commented 7 years ago

I'm not a great public speaker but sure. It's just a simple tool, so I think the talk will be (and should be) a quick one.

misaochan commented 7 years ago

Sounds good to me, have added you in. :)

misaochan commented 7 years ago

So it seems like we are close to having the minimum viable product ready for the switch to Wikidata. :) In that case, I figure we should tentatively switch the main task for the pre-hackathon and hackathon to (3) Displaying the Nearby results on a map (Android app) #334.

Additionally, we could work on any of the other issues that we are tracking, especially relevant ones like #502 , #508 etc.

nicolas-raoul commented 7 years ago

May I suggest #252 ? (Allow people to upload a picture for a given nearby item) so that people don't have to go edit Wikidata to make the item disappear.

misaochan commented 7 years ago

Yeah, that would be nice, perhaps also #278

misaochan commented 7 years ago

Being able to fix some of the high priority issues (albeit not necessarily Nearby-related) would be good too. #510 currently limits our userbase to those with mid-range phones and above I think, which is a limitation that we should try to remove. And #310 might be fixable with the help of others in the Wikimedia community during the hackathon.

whym commented 7 years ago

Would you like to talk briefly about the Commons app stats tool that you have created?

I've noticed that I might miss the opening by one or two hours. At best (and if the passport control is really fast for me) I might arrive just in time, but I'm not sure about that. @misaochan Would you like to talk about the stats tool for me, if I am not yet present by then? I can send slides beforehand.

misaochan commented 7 years ago

@whym I think it would be okay for your talk to be at a different time (perhaps after lunch). It might be a good idea to break up the talks anyway, and it isn't essential that people know about the stats tool before starting work. :)

misaochan commented 7 years ago

@maskaravivek I noted that on your application form you offered to help the newcomers with getting set up - that would be a great help, thanks! Can you be on hand for that after the introductory session? I will be helping as well, but it would be good to have two of us in case there is a substantial number of newcomers (not sure if there will be, but one can always hope :D)

whym commented 7 years ago

Ah right, after lunch sounds good to me.

misaochan commented 7 years ago

@whym If you manage to arrive on time, would you like to help me talk about the Nearby code? Since the latest incarnation of it is largely yours. No need to make any slides or anything for that one, we can probably just pull up the IDE on the projected laptop. I'll try and do what I can if you're not around, but if you are then you could probably clarify some things that I might miss.

whym commented 7 years ago

If you manage to arrive on time, would you like to help me talk about the Nearby code?

Sure, I'm happy to help. My knowledge tends to be limited to specific classes and methods I touched, though. I hope I can learn more about the classes I haven't touched and the overall structure during the hackathon.

misaochan commented 7 years ago

Final draft of program and selected tasks is up. As usual, feel free to discuss if you disagree with anything.

Also, please feel free to work on any of the tasks mentioned there before the pre-hackathon, especially those pertaining to bug fixes. We do not need to reserve all of them for the pre-hackathon/hackathon, if anything has already been fixed we can simply move on down the list. :)

misaochan commented 7 years ago

For the onboarding session during the hackathon, I was thinking that, after getting them set up, we could pick a few beginner-friendly tasks and let them try it on their own, helping them where needed? Would that be a good idea? (Edit: created new issue for this: #529 )

maskaravivek commented 7 years ago

@misaochan Sure, would love to help newcomers with that. :)