First Tasks: Difference between revisions

imported>Brittag
(→‎OpenStreetMap: linking to code)
imported>Shauna
 
(43 intermediate revisions by 6 users not shown)
You can see past first tasks, which have been successfully resolved, [[First_Tasks/Resolved | here]].
 
'''This page was last curated 2/14/Nov 15, 2014.''' Tasks on this page may have been resolved since then, so check their status in their respective issue trackers.
 
''Before you start working on any of these tasks, say hello in the list IRC channel so that mentors can help you pick issues (and avoid issues others have already picked).''
 
__toc__
 
Resources:
* temporary IRC channel: #openhatch-mainline
* [http://openhatch.readthedocs.org/en/latest/getting_started/project_overview.html Project Overview]
* [http://openhatch.readthedocs.org/en/latest/getting_started/installation.html Setting up the development environment]
Each of these is a bug that you should fix on your computer, and when you are satisfied with the fix, create a pull request for. These are supposed to be sorted from easiest to hardest, though your mileage may vary.
 
* Suggest a new design for http://openhatch.org/people/?q=python&center= <https://github.com/openhatch/oh-mainline/issues/1244>
* http://openhatch.org/bugs/issue926 -- on Windows, our use of the Tuffy font is very ugly. If you have Windows, you can help us out by looking into how we reference the Tuffy font, and see if you can find a version of Tuffy that renders more nicely on Windows. We'd love a pull request that lets us keep using this font that also makes it work on Windows! (If you try multiple things, and they all results in the same jagged-ness, then please also say so on the bug.)
** Why it matters: This page is one of the most-accessed pages on the site -- it's a way to see all the people working on any given project. But the interface is a little ugly.
** Skills you'll need (to have, or to learn): Reading CSS files; general understanding of web fonts.
** Skills you will learn and/or apply: Editing templates, or making "mock-ups" to indicate how you think a web page should look.
* http://openhatch.org/bugs/issue425 -- some time ago, people experienced a problem where when you logged into the site, a "Recommended bugs" area of your personal home page would spin forever. Does that still occur? Please update the bug with the results of your testing.
 
** Skills you'll need (to have, or to learn): Willingness to use a website and report on your experience via a bug tracker.
* Add a navigation link within a part of the site, so users don't get lost: https://github.com/openhatch/oh-mainline/issues/1385
* https://openhatch.org/bugs/issue948 -- adjust training missions' HTML to recommend a different command line web page downloader
** Why it matters: This part of the web app is easy for people to get lost in.
** Skills you'll need (to have, or to learn): Run the OpenHatch site locally; use command line tools (tar and curl); submit pull requests.
** Skills you will learn and/or apply: Django templates, general understanding of how web apps work.
** Other links: https://hashman.ca/gsoc/ is the blog posts by the author of this part of the site, which is the best documentation available for it.
 
* Add a resource link to the Basic Testing documentation <https://github.com/openhatch/oh-mainline/issues/1480>
** Why it matters: The OpenHatch project's documentation helps new users learn about testing through our docs as well as other resources.
** Skills you will learn and/or apply: Editing Python documentation using Sphinx & rST, which are common on the open source Python world.
 
* Add a new section to the Basic Testing Documentation (Test Output detail) <https://github.com/openhatch/oh-mainline/issues/1479>
** Why it matters: The OpenHatch project's documentation helps new users learn about testing and this is a useful developer option not yet documented.
** Skills you will learn and/or apply: Editing Python documentation using Sphinx & rST, which are common on the open source Python world. Testing basics.
 
* Verify installation instructions on Mac OS X Yosemite 10.10 <https://github.com/openhatch/oh-mainline/issues/1481>
** Why it matters: The OpenHatch project's documentation helps new users and it is useful to check if installation instructions work on new operating system releases.
** Skills you will learn and/or apply: Editing Python documentation using Sphinx & rST, which are common on the open source Python world. Installation basics.
 
 
Harder tasks:
* Footer doesn't always stick to the bottom of the page <https://github.com/openhatch/oh-mainline/issues/1437>
** Skills you will learn and/or apply: HTML, CSS
 
* https://openhatch.org/bugs/issue898 -- Sign up for an account on AppVeyor and configure their site to automatically periodically test if oh-mainline runs properly on Windows.
** Skills you will learn and/or apply: Automation (like scripting), using Windows.
 
* http://openhatch.org/bugs/issue917 -- The contact info form, the personal name editing form, the tag editing form do not use Django's "cross-site request forgery" protection. An independent security researcher found an issue on the site where we are not protected against this sort of attack. You may notice discussion of stickers on the bug; that's because we promised we'd send stickers to the researcher. Asheesh/paulproteus will be very happy to help you; find him on IRC!
 
* http://openhatch.org/bugs/issue71 -- add support to the site for Gravatars. Very open ended at the moment. I would prefer to leave the task of actually downloading the Gravatar to be done in the user's web browser, but that might seem kind of like an odd implementation strategy.
** Skills you will learn and/or apply: Reading documentation for third-party services; general understanding of HTML; editing Django templates.
 
= Open Source Comes to Campus=
Shauna added (integrated these when the above are checked):
 
Resources:
* Go through the laptop setup pages and add screenshots where you think they would be helpful. The issues say to add images to the issue, but you can upload them directly to the wiki if you like (though you may have to get permissions).
 
** [https://github.com/openhatch/open-source-comes-to-campus/issues/51 issue for linux screenshots]
* Main maintainer: Shauna (shauna on Freenode)
** [https://github.com/openhatch/open-source-comes-to-campus/issues/50 issue for mac screenshots]
* Main website: [http://campus.openhatch.org/]
** [https://github.com/openhatch/open-source-comes-to-campus/issues/49 issue for windows screenshots]
* Repository: [https://github.com/openhatch/open-source-comes-to-campus]
* temporary IRC channel: #openhatch-campus
 
Tasks:
 
* [https://github.com/openhatch/open-source-comes-to-campus/issues/95 Help us find an open source event calendar] Open Source Comes to Campus needs one, but we'd like help picking the right one. If you're interested in learning more about open source event calendar apps, this is the right task for you!
 
* [https://github.com/openhatch/open-source-comes-to-campus/issues/90 Add link to website] Our website is missing a link!
 
* [https://github.com/openhatch/open-source-comes-to-campus/issues/51 Go through the laptop setup pages and add screenshots where you think they would be helpful.] The issues say to add images to the issue, but you can upload them directly to the wiki if you like (though you may have to get permissions).
 
* [https://github.com/openhatch/open-source-comes-to-campus/issues/35 Reproduce documentation issue] A student reported an issue with the documentation for XChat. We've now switched to HexChat. Does the documentation still need to be fixed?
 
* [https://github.com/openhatch/open-source-comes-to-campus/issues/8 Help us research Linux installation and/or virtual machines] Great for someone with an interested in installing operating systems and/or virtual machines. Research what might be practical for an in person workshop, and report back what you've learned!
 
= Mozilla Firefox =
 
Mozilla, the non-profit makers of Firefox, creates products designed to help people take control and explore the full potential of their lives online.
 
Resources:
* temporary IRC channel: #openhatch-mozilla
* you can also check out the Mozilla server on IRC, as well as its channels #firefox, #webmaker, #sciencelab, #mobile and more
 
Good first tasks:
 
* Triage bugs in Firefox for Android: Improve the quality of bugs reported for Firefox on Android
** '''Why this matters''': Bugzilla is Mozilla's bug tracking system. This is where bugs are reported and where every change for a bug is stored and tracked. Bugs can stay unnoticed in Bugzilla for a long period of time. They are either not moved to the right component or are missing vital information to get them in developers’ hands. Help us reduce the number of UNCOnfirmed bugs in the Bugzilla database, and to improve the quality of the bugs reported.
** https://oneanddone.mozilla.org/en-US/tasks/20/
 
* Test the new Flash player for Firefox, called Shumway, by watching Flash videos and looking for differences.
** '''Why this matters''': Many websites use videos and ads created to run in Adobe Flash, a plugin that Firefox can't distribute. Shumway is Mozilla's implementation of Flash in HTML and Javascript. Once Shumway works reliably, Mozilla will be able to make Shumway the default Flash player for all Firefox users.
** https://oneanddone.mozilla.org/en-US/tasks/24/
 
= Merge Stories =
 
MENTOR: shauna or shauna_ on Freenode
 
Temporary IRC channel for this event: #openhatch-mergestories
 
Description: Merge stories are stories about all kinds of contributions that people have made to free and open source projects. They give details about the process: how people pick issues to work on, the common obstacles they run into, the resources they use to solve problems, and more. We hope that by sharing these stories, we can give newcomers a better sense of what contributing is like.
 
Resources:
* [http://mergestories.com/ The Site!]
* [https://github.com/openhatch/oh-contribution-stories The Repository]
* [https://github.com/openhatch/oh-contribution-stories/issues Issue tracker]
* [https://github.com/openhatch/oh-contribution-stories/blob/master/README.md Project overview/getting started]
 
Suggested Tasks:
* [https://github.com/openhatch/oh-contribution-stories/issues/42 Increase line-height via CSS to improve readability]: Make a minor change in the CSS to improve visibility/readability.
* [https://github.com/openhatch/oh-contribution-stories/issues/47 Remove relics from google forms]: Our submission form used to be a google form, and still has some unnecessary google-related CSS. Can you help us out by removing it?
* [https://github.com/openhatch/oh-contribution-stories/issues/37 Add a field to the submission form]: Story submittors should be able to link to their websites from their stories. Add an optional field to the submission form so they can do so.
* [https://github.com/openhatch/oh-contribution-stories/issues/33 Add a favicon]: Add a tiny icon to our url bar!
* [https://github.com/openhatch/oh-contribution-stories/issues/31 Add a 'read more' link to featured stories]
* [https://github.com/openhatch/oh-contribution-stories/issues/34 Create way for readers to share stories on social media]: There's a pre-made plugin that you can install. A great task if you want to learn more about how Pelican (the python-based static page generator this site is based on) works, and is also useful for seeing how to link between repositories in git.
 
'''Special bonus task''': Did you do one of the above tasks? Contribute to the project by submitting your own merge story!
 
= WelcomeBot =
 
Tasks:
 
* [https://github.com/shaunagm/oh-irc-bot/issues/1 Add rules to catch unidentified nicks] - When users who have registered their nicknames join IRC without identifying, different IRC clients will change their nickname in different ways. The bot currently only accounts for one of those ways, which means people are greeted unnecessarily.
* [https://github.com/shaunagm/WelcomeBot/issues/40 Make all function arguments keyword arguments]. In Python, arguments can be passed into a function with or without keywords. Without keywords, assignment of argument to variable is based on order. This is a messy way to live! Functions can also be called using keyword arguments of the form "keyword = value". Can you change the code so that all the arguments have keywords? Feel free to ask in IRC if you're not sure what the keyword should be - or guess. :)
* [https://github.com/shaunagm/oh-irc-bot/issues/12 Bot does not recognize fast name change] - When users join the channel and change their name, the bot uses their original name to greet them. A fix for this would likely involve:
 
* [https://github.com/shaunagm/WelcomeBot/issues/20 Test setup instruction] Can you try to get the bot running indefinitely and let us know if our instructions for how to do so need improvement? Great task for someone who wants to learn a new command line skill!
 
* [https://github.com/shaunagm/WelcomeBot/issues/47 Broken url when using webchat] When queried, WelcomeBot will tell you the url of the source repository. That url is bracketed by < and > because this helps the url work in most clients. However, this breaks the url in [http://webchat.freenode.net/ webchat]. Implement the proposed solution and test it in webchat!
 
Harder tasks that may still be fun:
 
* [https://github.com/shaunagm/oh-irc-bot/issues/10 Bot goes offline silently] - Every couple of weeks, the bot experiences a bug and turns off silently. Investigate tools like cronjob, monit, nagios, etc so that we can get a notification if it goes offline.
 
* [https://github.com/shaunagm/oh-irc-bot/issues/17 Make test suite] - If you like testing, this is the task for you! A good first step would be to read through the script and identify what needs to be tested. Alternatively, if you could read through some of the resources listed in the issue and report back what you've learned about doing tests in python, that would be super helpful too. This project's maintainer has never developed tests before from scratch, so we are all in it together. :)
* [https://github.com/shaunagm/oh-irc-botWelcomeBot/issuespull/1825 bugHelp causingrefactor botthis topull gorequest offlineso we can merge it] - ThisAnother maycontributor bemade a trickypull bugrequest tothat fix,let sinceWelcomeBot it'sreply notin clearprivate whatmessage inputwhen ispinged causingin theprivate crashmessage. and itUnfortunately, maythis bewas difficultdone toright reproducein (the botmiddle currentlyof crashes on this buga approximatelybig everyrefactoring twoof weeks)code. ButCan you mayhelp beout ableby totaking figurethis out whatperson's goingcode onand frommaking thea informationnew given!pull request out of it?
 
= OpenStreetMap =
 
Resources:
* temporary IRC channel: #openhatch-openstreetmap
* OpenStreetMap also has a community IRC channel here: http://wiki.openstreetmap.org/wiki/IRC
* you can also check out the Mozilla server on IRC, as well as its channels #firefox, #webmaker, #sciencelab, #mobile and more
* Overview: [http://www.openstreetmap.org/ OpenStreetMap website] - explore the map! Here's [http://www.openstreetmap.org/about a summary of the project], and [https://en.wikipedia.org/wiki/OpenStreetMap here's the Wikipedia article].
* Development information: [http://wiki.openstreetmap.org/wiki/Develop The "Develop" page] explains the main components of OpenStreetMap and how they fit together, linking to the code and issue trackers for those individual components. There are also lots of smaller OSM-related open source tools that aren't listed on that page, like the [http://tasks.hotosm.org/ OSM Tasking Manager] and [http://maproulette.org/ MapRoulette] projects mentioned below.
* Contact info: The #osm-dev IRC channel (on the OFTC network) includes many contributors. [http://wiki.openstreetmap.org/wiki/IRC Here's their page about IRC], including a webchat link you can use to connect to #osm-dev. The "Develop" page also links to a [http://lists.openstreetmap.org/listinfo/dev mailing list for developers].
 
Suggested tasks:
 
* '''Testing documentation''': OSM wants people to be able to easily use its freely-licensed data instead of using Google Maps data, so it has a website teaching people how to do this: [http://switch2osm.org/ Switch2OSM]. The author of the [http://switch2osm.org/loading-osm-data/ "Loading OSM data" article] (pnorman on IRC) would like feedback on this article! This article expects having access to an Ubuntu instance, and it is designed to be usable for anyone with basic Linux and PostGreSQL knowledge. You can write down comments about the article (and any difficulty you ran into while following it), such as in an Etherpad, and then send the link to pnorman in the #osm-dev IRC channel. If you don't already have convenient access to a computer or server running Ubuntu, you can try setting up a [http://aws.amazon.com/free/ free Amazon Web Services EC2 "microinstance"] to play with.
* '''Fixing frontend code''': [http://maproulette.org/ MapRoulette] is a fun tool that recommends map edits for you to make. The code is [https://github.com/osmlab/maproulette on GitHub here], with [https://github.com/osmlab/maproulette/issues issues listed here]. This issue looks like a good one to get started with fixing: [https://github.com/osmlab/maproulette/issues/224 "because we use element fadeouts quite a bit, we should probably disable buttons visually right when the user clicks them - right now there is no visual feedback when clicking a button, other than the dialog fading"].
* '''Verifying a reported frontend bug''': The [http://tasks.hotosm.org/ OSM Tasking Manager] also helps map editors find editing tasks to work on. The code is [https://github.com/hotosm/osm-tasking-manager on GitHub here], with [https://github.com/hotosm/osm-tasking-manager/issues?state=open issues listed here]. You could help the project by seeing if you can reproduce this reported bug: [https://github.com/hotosm/osm-tasking-manager/issues/195 "Seems when scrolling up or down with the mouse wheel within the embed map, it moves both the map scale and the webpage scrollbar"] - and then add more details to that bug in a comment.
* '''Changing frontend code''': The [http://davis.openhatch.org/ OpenHatch at UC Davis] page uses a Google Map - how about switching that to an OpenStreetMap instead? Here's some documentation for how to do this: [http://wiki.openstreetmap.org/wiki/Export#Embeddable_HTML "Embeddable HTML with an added Marker"]. The code is here: [https://github.com/oh-davis/oh-davis.github.io oh-davis.github.io].
* '''Writing user experience feedback''': Make an OpenStreetMap account and try making some map edits (such as correcting any incorrect streets or street names in your neighborhood), and write down notes on your thought process and any problems you encounter, especially parts of the interface you find confusing or frustrating. The default map editing tool is called [http://wiki.openstreetmap.org/wiki/ID iD], and you can [https://github.com/openstreetmap/iD/issues file bugs here]. If you don't know exactly what to report as a bug, you can also write about your experience on the OpenStreetMap website using the built-in [http://www.openstreetmap.org/diary "diary entry"] feature, and then other OpenStreetMap developers and users can read your feedback to help them figure out how to improve OpenStreetMap.
 
= TEMPLATE: NAME =
Anonymous user