The Technical Collaboration team wants to improve the organization and documentation of our annual plan programs.
For each program, we expect:
- Goals, outcomes, and milestones described and reflected in Phabricator tasks.
- Logic model.
- Timeline and updates.
- Metrics.
Structure
- Each program has a Phabricator task, from which related subtasks are created, i.e. T164084: [FY 17-18] Program 12: Onboarding new developers
- Each program has a wiki page in Meta, which is linked from the Wikimedia Foundation annual plan, i.e. https://meta.wikimedia.org/wiki/Technical_Collaboration/Onboarding_New_Developers
- The program wiki page has this table of contents:
- Overview, where the basic information is provided.
- Key progress indicators
- Goals, offering one section per goal, where quarterly updates per goal are being provided.
- Other achievements not fitting in the goals above, organized per quarter.
- Lessons learned (aka "What would you do differently if you had to do it again?" and "Did you struggle with anything?"), organized per quarter.
- Scorecards, which would be transcluded from https://meta.wikimedia.org/wiki/Technical_Collaboration/Metrics thanks to section transclusion magic.
Updates
In an ideal world, we would be updating these pages as relevant news arrive. Then, when preparing our next Community Engagement Quarterly Check-in, we would only need to move this content to the presentation slides.