Wikimedia Discovery/Team/Onboarding/Deborah
Team page: Discovery
Note that if you are seeing this in a page who's URL ends in /YourName then you should feel free to strike through the steps are as you finish them. If you find an error in the instructions then go fix them on the template.
Things to do on your own[edit]
First day[edit]
- IRC
Get an IRC client. Some people like Quassel. weechat and irssi are good if you like text interfaces.
.Connect to Freenode and register your user nameJoin#wikimedia-discovery connectThe rest of the team will be in there and we'll use this room to keep up with you.Skim the "People to meet/First day" section below and keep some of the irc names in mind. Chat with them when we get bored of the tasks below and need a break.If you get stuck on anything just shoutin #wikimedia-discovery connect.
- Have a quick glance at the section of this page title "Who to ask if stuff doesn't work". You should refer to it if stuff doesn't work.
- Also, remember to update the template with any better information or useful tips you discover.
Password ManagementYou are about to get approximately one billion new passwords. You might want to set up a Password Management tool.Wikimedia Password NotesYour Google Apps / Gmail / Calendar password can be resethere.- You may need to log into the VPN to access that URL. (OIT says it's sometimes necessaryâit's voodoo)
You can log into Loomio and ZenDesk via your Google account.
Your Wikitech (see below) account/password (see below) is also your login for Phabricatorand Gerrit- office.wikimedia.org
has it's own password - mediawiki.org, en.wikipedia.org, etc,
share a password (see "View global account info" under yourWikipedia prefs). - When you start signing up for mailing lists (see below), request a password reset for one of them, then choose a password you like for that one, but check the "change globally" checkbox and they'll all get that password.
Log into Collab and reset your password- Note that "LDAP" is not unique:
- OIT (Office IT) uses LDAP to refer to your Google Apps password.
- Your Wikitech password is called LDAP in some places.
- These are not the same LDAP systems and so not necessarily the same passwordâoh, the confusion!
- NOTE: Some of these tasks can be found by reading the new hire information but we've made an effort to grab the important bits.
- Read the Systems Guide for New Hires.
- Google Mail/Calendar
Follow the systems guide above and/or your On Boarding Confirmation email from OIT to get access to gmail and your calendar.- (Optional) In Gmail, enable Settings -> Labs -> Undo Send and press Save Changes. Go back to settings and change the timeout to 30 seconds.
Add these calendars to your calendarcalendars: "WMF Staff Calendar", "WMF Sick/Vacation Tracking Calendar", and "WMF Fun & Learning".- A
sk someone to give you permission to "Make Changes and Manage Sharing" for the "WMF Sick/Vacation Tracking Calendar"(anyone already on the calendar can do so) - The WMF Fun & Learning calendar isn't super useful for remote employees.
- A
- I
n Calendar go to Settings and (i) tick "Speedy Meetings" and (ii) set your work hours.
- IRC (part two!)
Join#wikimedia-discovery connect, #wikimedia connect, #mediawiki connect, #wikimedia-operations connect, #wikimedia-office connect, #wikimedia-dev connect- L
earn about cloaksand request one. (rqsted cloak 1/5/2016)It can take a few days for the cloak stuff to be resolved.
Verify access to Office, Wikipedia, and Wikimedia Foundation with the appropriate WMF accounts.These accounts will be created by OIT. Email techsupport@wikimedia.org if you don't get email with login info.
- Create a Wikitech account
- Beware: it seems to want to uppercase the first letter of your username whether you like it or not.
Schedule staff photo(just list your name here)Or you can list yourself as not wanting to have your photo up by adding your name under the cloak of invisibility list.
Add yourself to the team pageâtwice: in the info box at the top of the page, and under the section "The Team | Members".- Subscribe to some mailing lists
- The public search list
- The private search list
- Wikitech-l the Newspaper of record for changes to MediaWiki.
- Introduce yourself on wikimedia-search.
Create your account onmeta.wiki
First few days[edit]
IRC (part three!)If you know what an IRC bouncer is, get one of those and set it up so you are "always on"If not, talk to someone about getting a WMF account on IRCCloud.
We have a saying: "If it didn't happen on the mailing list, it didn't happen"âso important stuff should be on the public or private mailing listâbut it's polite to check back on IRC when you've been away (hence the need for a bouncer or IRCCloud).- See also https://www.mediawiki.org/wiki/Wikimedia_Discovery/Process#Communication
PhabricatorSet up your Phabricator account. Follow these instructions to set up your account.Now you need to get yourself added to the WMF-NDA project. This will allow you to view certain tasks which are hidden to people who haven't signed a WMF NDA. Employees had to sign an NDA, so assuming you are an employee, this should go smoothly.In your phabricator profile, make sure your phabricator account is associated with your MediaWiki user account.Create a task titled "Add (your phab username) to #wmf-nda", and add the  WMF-NDA-Requests project. Mention in the description that you are an employee. It's OK to leave the "Assigned To" field empty since project members will see the request.
Add yourself as a member of the Discovery Phabricator Project.Create a Phabricator task for working through this worksheet. Assign it to yourself and attach it to a semi-relevant sprint, then move it to the "In Progress" column of that sprint's workboard.- Read more about our development process.
Look at the backlogs for our projects. Get a feel for the backlog of your project.
- If you're not a Wikipedia editor yet, ask Max or Dan to give you an introduction.
LoomioI think you'll need to get invited into the WMF loomio group- And if you want to participate in the "Office Incubator", you'll need an invite for that too
Optional stuff, for the technically inclined[edit]
- git
- Read the tutorial on our git/gerrit workflow.
- Install git.
- Install git-review.
- Add yourself to some Gerrit review group(s).
- Skip down to the section on MediaWiki-Vagrant and start on that. When you run
vagrant up
for the first time it'll take a long, long while. So come back and continue from here while you wait for that. - Read How to become a MediaWiki hacker.
- Install MediaWiki-Vagrant
- After you verify that you can create pages and such add the
cirrussearch
role, runvagrant provision
and try searching
- After you verify that you can create pages and such add the
- Work on something small!
- You can ask anyone for an issue to work on but officially your point of contact for this is Dan.
- Submit the patch using
git review
and anyone on the team as a reviewer. - Try to pick something that seems small so that you get used to the code review process quickly but don't worry if you can't finish it in a day or a week.
- Its likely that you won't get a response immediately when you push a patch for review. That's normal. You can continue other things in this document or grab another bug, whatever feels right to you.
- Ask for help if you need it!
People to meet and things to do with them[edit]
You'll want to meet these people soon, some on the first day! You should probably introduce yourself over IRC and ask to schedule a Google hangout with them.
The goal of this section is to meet some of your team mates and learn how the team fits together. Hopefully you'll talk to everyone on the team one on one for about thirty minutes over the first week or two and a few key people on your first day.
First day[edit]
- Dan aka Deskana, our Lead Product Manager, and your line manager. He is on US West Coast time.
- Speak to him about the product roadmap and goals of Discovery and the Wikimedia Foundation
- Ask him about how product works at the Foundation and with in the Discovery team.
- Testing overview - in house and Specialists Guild
- Wikimedia project overview - what are our projects and who uses them
Introduce yourself to Kevin aka meeple27, our team practices coach. He is on US West Coast time.Ask him to add you to the appropriate meetings.Ask him to explain how we communicate and track our work.Ask him how he fits in with the rest of the team.
First week[edit]
- Tomasz aka tomasz, the Head of Discovery. He is also on US West Coast time.
- Tell him everything is going great and that the instructions are easy to follow but you are still overwhelmed by the reading you have to do.
- Tell him that you found some errors in the instruction and fixed the template.
- Just kidding.
- Ask him to give you an overview of how the foundation is organized, teams and such.
- Also ask about how the Discovery team is organized internally.
- He'll want to talk to you one on one a few times in the first week.
- Moiz aka moizsyed, our Design Manager. He is also on US West Coast time.
- Ask about how UX/Design works with the rest of the Discovery team.
- Erik aka ebernhardson, one of our multi-talented software engineers. He is on US West Coast time.
- Ask him about vagrant and ask him to show you how to run the browser tests.
- Ask him what he's working on now.
- Oliver aka Ironholds, one of our analysts. He is on US East Coast time.
- Ask him about dashboarding and what kinds of data we collect and are trying to collect.
- Ask how we know if users think our results are good.
- Stas aka SMalyshev, our wikidata expert. He is on US West Coast time.
- Ask him about what Wikidata is and what the Wikidata Query Service is.
- Have him give you access to a public beta instance of it and walk you through running some queries.
- Max aka MaxSem, one of the two developers working on maps. He is on US West Coast time.
- Ask him to show you his work on maps and explain how it works and why it's so cool.
Jan and Julian, two developers working on the portal pageask them about what their ideas are on how to make the portal page better
Yuri, the other developer working on mapsask him about all the things he wants to do re: maps
Who to ask if stuff doesn't work[edit]
Search Team Contact | Owner | IRC Channel | |
---|---|---|---|
MediaWiki-Vagrant | ebernhardson | ori, bd808 | #wikimedia-releng |
CirrusSearch and Elasticsearch | ebernhardson / dcausse | ebernhardson / dcausse | #wikimedia-discovery |
Wikidata | SMalyshev | DanielK_WMDE, aude, Lydia_WMDE | #wikidata |
Wikidata Query | SMalyshev | SMalyshev | #wikimedia-discovery |
MediaWiki | ebernhardson, MaxSem | #wikimedia-dev | |
MediaWiki Job Runner | AaronSchulz | #mediawiki-core | |
git/gerrit | Anyone in #wikimedia-discovery | ^d | #mediawiki-releng |
Jenkins | ebernhardson | hashar, zeljkof | #mediawiki-releng |
PHP | ebernhardson, SMalyshev | #wikimedia-discovery | |
JavaScript | ori | #wikimedia-discovery | |
Java | SMalyshev / dcausse | #wikimedia-discovery | |
Phabricator | meeple27 | #wikimedia-devtools | |
Discovery Dashboards | bearloga, Ironholds | #wikimedia-discovery |