Open Source Comes to Campus/Tasks for Oct 18th

Hi! You've reached the "contributions workshop" part of the event - congratulations!

This page exists to provide you with some small tasks to get you started contributing to open source projects. Every project on this page has:


 * Clear instructions for how to contribute to their project, including setting up a development environment, contributing changes, and how to contact them.
 * At least one hand-picked task that (hopefully!) can be completed within an hour or two.
 * At least one maintainer/contributor who's really excited about welcoming you to their project.

Make sure you contact that maintainer before getting started! They will be listed under "mentor" and will be available either in-person at your event or via IRC.

If you don't want to work on these particular projects, that's okay. There's a few other things you can try:

Newcomer tasks are kinds of tasks that are relatively easy for newcomers to perform, since they don't require a ton of experience either with the project or with FOSS at large. Despite this, these tasks are all really useful for most projects! And you can do them for any project. These tasks are:
 * Improving website accessibility for people with visual impairments
 * Trying out "Getting Started" guides and installation instructions and giving feedback.
 * Going through bug reports and pull requests and testing them out.

 Recommended projects: These are projects with great communities that have good getting started instructions. They're not affiliated with this event, but they're likely to welcome you with open arms.

 Finding a Project: If you want to find your own projects and your own tasks, try going through this exercise.

= WelcomeBot =

MENTOR: Shauna (shauna or shauna_ on Freenode)

Description: WelcomeBot is an IRC bot designed to welcome people into the #openhatch IRC channel (although it can be easily adapted for use in other channels). It is written in python, and features the socket module.

Resources:
 * Source
 * Overview and installation/contributing guides: can be found in the repository's readme
 * Updates/problems/ideas: Please use the issue tracker! (As well as asking shauna about them on IRC.)

Tasks:
 * Add rules to catch unidentified nicks: When you join an IRC network, you pick a nickname or nick. If you want to keep the same nick forever, you can register it the network and set a password. Then, each time you join, you "identify" to the network by telling them the password.  Simple, right?  If you don't identify, your IRC client may automatically change your nick slightly, for instance by adding a trailing underscore.  We want WelcomeBot to understand that user and user_ and user__ are all the same person.  We've found some of the rules, but not all of them.  Can you add another rule?
 * Fix docs to specify what version of Python you need: Our docs currently do not specify that the bot does not work with Python 3. Can you update our docs to fix this?  A good, simple task to practice using git.
 * WelcomeBot replies to PMs in #openhatch always: When someone private messages the bot, it responds in the channel. Can you fix this so that the bot responds on the channel when it's messaged on the channel and privately when it's messaged privately? There's a pull request already with a fix but it was written before WelcomeBot was refactored.  You can use the PR as inspiration to make this fix.
 * Bug when running WelcomeBot on the Mozilla server: Can you reproduce this bug by trying to run WelcomeBot on the Mozilla network (as opposed to Freenode)?
 * Unnecessary file in the repository: Can you get rid of this unneeded file? A good, simple task for folks looking to practice with git/github.
 * Test our docs: Our documentation currently includes instructions for setting up the bot to run indefinitely. Can you try to follow the docs and see if they're missing information?
 * Make function arguments keyword arguments: Helps improve readability. A good task to do while reading through the code and trying to figure out how it works.

Harder tasks that may still be fun:


 * Add a function for identifying to your bot's registered nickname: When you join an IRC network, you pick a nickname or nick. If you want to keep the same nick forever, you can register it the network and set a password. The bot currently can only used unregistered nicknames, because it doesn't have a function to identify to the server.
 * Change hard-coded values in testing suite: The testing suite hard-codes certain variables into the tests. They need to be replaced with variables.

= Merge Stories =

MENTOR: Shauna (shauna or shauna_ on Freenode)

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:
 * The Site!
 * The Repository
 * Issue tracker
 * Project overview/getting started

Suggested Tasks:
 * Increase line-height via CSS to improve readability: Make a minor change in the CSS to improve visibility/readability.
 * 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?
 * 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.
 * Increase padding between stories on front page: We've gotten some design feedback that our front page could use some adjusting to look more pleasant and readable. Should be a straightforward CSS fix.
 * Add a favicon: Add a tiny icon to our url bar!
 * Add a 'read more' link to featured stories
 * 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!

= OpenHatch =

MENTOR: Asheesh (paulproteus on #openhatch on Freenode), and probably others on #openhatch on Freenode.

Description: OpenHatch.org sees itself as "free software's welcoming committee." We make web tools and run events to help people join open source projects, primarily in Python and Django with some Javascript, CSS, and HTML. We're always looking for enthusiastic new people willing to file bugs, submit patches, ask questions, write documentation, and review code. To help you imagine the site, the volunteer opportunity finder helps people find "easy" bugs to work on in projects all over the web, and supporting code to download that data through API use and scraping; the profile tool helps people write about their experience contributing to open source; and the training missions are interactive, plot-based teaching tools to help people learn skills required in open source in a friendly setting.

Resources:
 * Project Overview
 * Setting up the development environment
 * Contributing changes
 * Code: https://github.com/openhatch/oh-mainline

Tasks:

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.


 * https://github.com/openhatch/oh-mainline/issues/1447 -- Two template files have confusing filenames. We would like someone to rename them!


 * https://github.com/openhatch/oh-mainline/issues/1446 -- Some of the images on website need ALT text added. The bug covers this and one other accessibility-related issue.

Past here, ???


 * 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.)
 * Skills you'll need (to have, or to learn): Reading CSS files; general understanding of web fonts.

Harder tasks:
 * 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.


 * 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.

Shauna added (integrated these when the above are checked):


 * 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).
 * issue for linux screenshots
 * issue for mac screenshots
 * issue for windows screenshots


 * 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?

= MediaWiki =

MENTOR: Mark (marktraceur on Freenode)

Description: MediaWiki is a free software open source wiki package written in PHP, originally for use on Wikipedia. It is now also used by several other projects of the non-profit Wikimedia Foundation and by many other wikis, including this website, the home of MediaWiki.

Resources:
 * Getting started guide

Tasks:
 * Tasks that Mark can help with are here
 * A greater variety of tasks, and the Wikimedia contributor portal, are here.