Open Source Comes to Campus/Tasks for Oct 18th: Difference between revisions

imported>Shauna
No edit summary
imported>Shauna
 
(18 intermediate revisions by 2 users not shown)
Line 25:
 
MENTOR: Shauna (shauna or shauna_ on Freenode)
 
Temporary IRC channel for this event: #openhatch-bots
 
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 [http://docs.python.org/2/library/socket.html socket module].
Line 50 ⟶ 52:
 
MENTOR: Shauna (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.
Line 72 ⟶ 76:
= OpenHatch =
 
MENTOR: Asheesh (paulproteus on #openhatch on Freenode), and probably others on #openhatch on Freenode.
 
Temporary IRC channel for this event: #openhatch-main
 
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.
Line 86 ⟶ 92:
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.
 
 
* 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.)
* https://github.com/openhatch/oh-mainline/issues/731 -- this requires looking at the bug, and seeing you also experience the bug, and then posting a note on the bug indicating if you do or don't experience the bug. If we're all lucky, the bug has gone away, and you can leave a note indicating that it can be closed! If not, then you can help us prioritize it by indicating that the problem remains.
** Skills you'll need (to have, or to learn): Reading CSS files; general understanding of web fonts.
** Skills you'll need (to have, or to learn): Using websites; leaving a comment on GitHub.
 
* https://github.com/openhatch/oh-mainline/issues/1447 -- Two template files have confusing filenames. We would like someone to rename them!
** Skills you'll need (to have, or to learn): Using git; reading Python code.
 
 
* https://github.com/openhatch/oh-mainline/issues/1427 -- Adjust a link in our documentation, so that it no longer points people at a URL that does not load properly.
** Skills you'll need (to have, or to learn): Reading CSSrST files;(marked generalup understandingtext) of web fontsfiles.
 
 
* 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.
** Skills you'll need (to have, or to learn): Understanding the purpose of ALT text in images; understanding the notion of accessibility. Finding and editing the templates that power the OpenHatch website.
 
 
* https://github.com/openhatch/oh-mainline/issues/991 -- Find some text in a template, and make it more easily understandable.
** Skills you'll need (to have, or to learn): Finding an editing the templates that power the OpenHatch wbs
 
 
* https://github.com/openhatch/oh-mainline/issues/1443 -- Change some Python code to fix our ''robots.txt'' file, which recently removed the OpenHatch website from search indexes!
** Skills you'll need (to have, or to learn): General understanding of the notions of web robots & robots.txt rules. Tracing through a urls.py file to find the right file to edit; writing Python/Django code. Preferably, writing a test for Django code.
 
 
* https://github.com/openhatch/oh-mainline/issues/1448 -- fix some Python code to request a URL with the right User-Agent header, so that the site does not block our request.
** Skills you'll need (to have, or to learn): Reading Python code. Understanding the idea of a User-Agent header. Modifying Python code.
 
 
* https://github.com/openhatch/oh-mainline/issues/1369 -- Fix a CSS alignment issue, where some boxes are about 20 pixels mis-aligned with other boxes, on the homepage.
** Skills you'll need (to have, or to learn): Visually identifying layout problems. Finding and modifying CSS files.
 
 
* https://github.com/openhatch/oh-mainline/issues/1437 -- For pages that do not have content that fills them entirely, the footer does not stick to the bottom of the page. It could be fixed with a bit of CSS.
** Skills you'll need (to have, or to learn): Visually identifying layout problems. Finding and modifying CSS files.
 
 
* https://github.com/openhatch/oh-mainline/issues/1332 -- Fix a data validation problem, where we try to convert a string to an integer and crash when we do not succeed.
** Skills you'll need (to have, or to learn): Reading & writing Python code; general understanding of data types (string, int, etc.). Writing a test for Django code.
 
 
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.
** Skills you'll need (to have, or to learn): General familiarity with Windows and git.
 
 
* http://openhatch.org/bugs/issue71 -- add support to the site for Gravatars.
** Skills you'll need (to have, or to learn): Sizeable understanding of Django, user profile photos, and the (free of cost) Gravatar online service.
 
 
Other tasks:
 
The following issues are not bugs in the openhatch.org website; they're issues in the openhatch.org ''wiki'', our collaborative documentation area. Note that they're on a separate GitHub project called ''open-source-comes-to-campus'', which happens to be related to the event you are at!
* 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 required for this:
Shauna added (integrated these when the above are checked):
* Following instructions on a wiki page; taking screenshots on your own computer. Optional: requesting admin access to the wiki, in order to be able to upload files.
 
* 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).
Line 107 ⟶ 159:
 
MENTOR: Mark (marktraceur on Freenode)
 
Temporary IRC channel for this event: #openhatch-mediawiki
 
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.
Anonymous user