Wikimedia Engineering/Report

Style guidelines

 * Use a matter-of-fact tone, to be consistent with the rest of the document.
 * Use the simple past consistently; avoid too much projection in the future. We're reporting on what you did, not what you are or will be doing.
 * The report is long and includes a lot of different materials; be succinct.
 * Give credit where appropriate. "We" is vague; instead, name your team members and their accomplishments. It's clearer for the audience, and more gratifying for your team.
 * Avoid buzzwords and peacock words (see the English Wikipedia's full list of words to watch)

Over the month

 * When personnel changes are made, add them to the draft report page, along with a link to the public announcement.

Second-to-last week of the month

 * Update the list of projects based on projects listed as "Current" on the team hubs (Wikimedia Features engineering, Wikimedia Mobile engineering, Wikimedia Platform Engineering and Wikimedia Language engineering);
 * Send an e-mail to engineering@ and contractors you know about (i.e. Wikidata people, Offline people, Wikia people) asking for status updates, and give a deadline.

Last week of the month

 * Clean up and copyedit the draft;
 * Check all links;
 * Add an introduction summarizing the main accomplishments, by listing what was featured on the Wikimedia tech blog.
 * Check that "Priority activities" have status updates. As of June 2014, those activities (and people to ping if statuses are missing) are: VisualEditor & Parsoid (James Forrester), Editor Engagement (Danny Horn), Growth (Steven Walling), and Mobile (Maryana Pinchuk [web] and Dan Garry [apps])

Fill out the Metrics box

 * For committer stats for the last 30 days, follow instructions in this wikitech-l post.
 * Or,   with the username and date changed. The   means 'exclude patches that have not been touched in the last 40 days', which casts too wide a net, but then filtering for   restricts it to whatever month it was 27 days ago according to your local machine. (so it expands to something like  ) Then subtract 1 to account for L10n-bot.
 * A bugzilla query (update the date parameters) provides the shell requests stats.

Immediately before publication

 * Check one last time the Job openings on the WMF website to make sure they're all listed, and expired openings have been removed;
 * Read the whole post carefully one last time, paying attention to grammar, spelling & typography;
 * Check all links one last time.

After publication

 * Update the [ latest report] and [ next report] redirects.
 * Send a heads-up to wikitech-l and wikimediaannounce-l and wikitech-ambassadors containing a link to the report (the report's size is too big to send to the mailing list).
 * Add the report to the Reports and Wikimedia Foundation reports pages on meta, in the Technology section;
 * Add the report to the Foundation wiki's main page: foundation:Template:Reports-en;
 * Review comments as they arrive, and if necessary ping the appropriate people to respond.

Set up the next report

 * Create a page for the next report, using the previous report as template. Update the date for status transclusion, and comment out previous statuses if they weren't transcluded.