Template:Readers/Software Engineer onboarding

Hire

 * Copy this page somewhere and strike through items as you work through them.
 * Write up an introduction email for yourself written in the third person, and send it to your manager for review, so your manager can share on the staff mailing list.
 * Read the guide for new hires, including the "guide for new engineering staff"
 * (Optional) In Gmail, enable Settings > General (tab) > Undo Send and change the timeout to 30 seconds and press Save Changes
 * If you like, arrange for a photo for the Staff & Contractors page. A high quality photo captured from a smartphone is fine. If you want an affordable professional photograph taken, please consult with your manager. Once you have a good photo, please upload it to Wikimedia Commons with a standard open access license from the picklist and share the URL with your manager so it can be conveyed with HR.
 * Set up IRC . Join the #wikimedia-staff (requires invitation), #wikimedia-mobile, and #wikimedia-operations (#wikimedia-staff is also helpful for some public events). Review other channels for your interests. Attach an IRC cloak. If you don't already have an IRC client, consider using IRCCloud, a web-based client popular among Foundation staff.
 * Review our guide to the various Wikimedia wikis.
 * Verify WMF access to Gmail, Office (standalone), and Wikipedia / MediaWiki.org (SUL)
 * https://lists.wikimedia.org/
 * Subscribe to mobile-l with Wikimedia email. Default list for discussions for mobile-related or Readers audience vertical topics.
 * Subscribe to wikitech-l with Wikimedia email. Default list for tech discussions on Wikimedia and MediaWiki software.
 * Subscribe to mediawiki-api and mediawiki-api-announce with Wikimedia email. Lists about internet facing APIs.
 * Subscribe to analytics with Wikimedia email. List about analytics.
 * Subscribe to newreaders with Wikimedia email. Public discussion about New Readers.
 * Verify access to engineering list with Wikimedia email. Public facing list for all software engineers. Contact Rachel F if you still need access.
 * Set up your LDAP account (used for Wikitech and Gerrit) following How to become a MediaWiki hacker instructions.
 * Commonly, the username you use is your internet handle (i.e., not a (WMF) username), but you will want to use your @wikimedia.org email address for the email address to receive Gerrit email notifications.
 * Also, if you are a software engineer, request access to the group ldap/wmf, adding your manager to the access request task for approval. This group gives you more code review approval rights in the system as well as access to myriad different tools and services.
 * If appropriate, apply for access to stat servers and operational logs. Request access to "request logs, including Hive, and event logging", as referenced in the data access guidelines.
 * If you will be doing deployment related work (typically, for web engineering and content services), request "deployment access and operational logs access" when following the steps for shell access.
 * Apply for beta cluster event logging access
 * Fix a small bug. Plenty abound, we can pick one as time gets nearer. Get the patch through Gerrit / GitHub and get it merged.
 * Fix a couple more small bugs to get a clearer idea of how things are
 * Take up a card with the product owner and team, and go through the full cycle to implement it
 * Review team norms, values , and roles and responsibilities
 * Read about Readers
 * Read about the Movement Strategy, quarterly goals , WMF annual plan for FY 2018-2019 (June 2018 - July 2019) , and New Readers progress . Also review the original Reading strategy to contextualize our progress.
 * Read The Wikipedia Revolution and Debugging Teams: Better Productivity through Collaboration (Brian W. Fitzpatrick and Ben Collins-Sussman)
 * Watch this video of Joel Spolsky at Wikimedia
 * Read some blog posts, like Why it took a long time to build that tiny link preview on Wikipedia.
 * Review the most recent Readers quarterly check-in Q3 Audiences check-in and Q3 Audiences metrics (as of 5-June-2018)
 * Set meetings with product managers and program managers to learn about products and programs: Web (Olga V), iOS (Josh M), Android (Charlotte G), Multimedia (Ramsey I), New Readers program (Anne G), Structured Data on Commons program (Amanda B), Platform Evolution program (Corey F)
 * Set one time meetings with all Readers engineers to say hi - one every other day is a good tempo
 * Scan the English Wikipedia Village Pumps, Commons Village Pump + related Commons pages
 * Starting on making 50 edits on a broad range of user agents, form factors, network conditions, etc. - MediaWiki.org and Office Wiki are simplest for your work account. Remember, your personal edits on project wikis are your personal edits. Some help: Help:Wiki markup, Help:Wikitext examples

= Team =
 * Scrummaster
 * With admin, add to relevant calendar invites: Standup, Weekly meetings, etc. (e.g., Reading Web)
 * Add to relevant team page on mediawiki.org
 * Explain team development cycle (e.g., Reading Web), project management tools, Phabricator workflow and meeting scheduling (checking individual calendars and room availability, etc)
 * Check-in meeting/agile orientation
 * Product Manager
 * Introduce to team members who haven't met new software engineer
 * Product overview
 * Testing overview - in house and Specialists Guild
 * Wikimedia project overview - what are our projects and who uses them
 * Director
 * Subscribe to reading-wmf. Use for administrivia (vacation, missed meetings, standup status)
 * Discuss career development and open lines of communication, first six months, privacy/security principles and techniques, email/chat clients/calendar productivity tips
 * Manager
 * Ask Engineering Admin to add to product-all, plus the following calendars:"WMF Engineering", "WMF Sick/Vacation Tracking Calendar", and if in San Francisco "WMF Fun & Learning".
 * Ask HR to add "WMF Staff Calendar"
 * Setup on team internal mailing list
 * Designer, Design Research
 * UX / Design overview
 * Design research overview
 * Tech Lead
 * Explore Gerrit workflow. Review Gerrit tutorial . Install git-review.
 * Suggest appropriate Gerrit review group(s).
 * Explore GitHub workflow.
 * Review internet facing APIs
 * Guide through setup of Vagrant
 * Explain MobileFrontend (Reading Web tech lead should explain)
 * Explain Mobile Content Service (Mobile Content Service engineering point of contact)
 * Community Liaison, Technical Collaboration
 * Facilitating communications from and to the WMF's Product and Engineering departments
 * Assisting with testing, bug filing, documentation writing
 * Delivering announcements, news, and feedback
 * Engaging translators for the user interface and for documentation
 * Everyone
 * Take a pause and let them explore

= Welcome Email =

Greetings,

If you're reading this then you're likely a new member of the Readers audience vertical at the Wikimedia Foundation. Welcome! We're really excited to have you join us and want to make your first days/weeks/months both productive and fun. Here are some quick links to get you started.

Our team: https://wikimediafoundation.org/wiki/Staff_and_contractors#Readers

Team portal: http://www.mediawiki.org/wiki/Readers

Chat: IRC #wikimedia-mobile (freenode)

Code: MobileFrontend Extension: https://www.mediawiki.org/wiki/Extension:MobileFrontend Android App: https://gerrit.wikimedia.org/r/#/admin/projects/apps/android/wikipedia iOS App: https://github.com/wikimedia/wikipedia-ios And there's more!

Email: mobile-l@lists.wikimedia.org (Public default discussion list) wikitech-l@lists.wikimedia.org (Public technical discussion list) mediawiki-api@lists.wikimedia.org (Public technical discussion list) mediawiki-api-announce@lists.wikimedia.org (Public API announcements list) analytics@lists.wikimedia.org (Public analytics list) reading-wmf (Internal administrivia)

Other useful links: How to become a MediaWiki hacker: https://www.mediawiki.org/wiki/How_to_become_a_MediaWiki_hacker

Guide to using Git and Gerrit for MediaWiki development: https://www.mediawiki.org/wiki/Gerrit/Getting_started

Coding conventions: https://www.mediawiki.org/wiki/Manual:Coding_conventions

Security for developers: https://www.mediawiki.org/wiki/Security_for_developers

How to localize MediaWiki software: https://www.mediawiki.org/wiki/Localisation

Wikimedia Bugs: https://https://phabricator.wikimedia.org/

MediaWiki.org (MediaWiki documentation): https://www.mediawiki.org/wiki/MediaWiki

Wikitech (Wikimedia internal documentation): https://wikitech.wikimedia.org/wiki/Main_Page

Office Wiki: https://office.wikimedia.org/wiki/Main_Page

If you get lost or are confused about what you should be doing then grab one of your new teammates and chat over coffee, tea, yerba maté, milk, water, beer, etc.

We're happy to have you with us!