Page MenuHomePhabricator

GSoD 2024 statement of interest: Complete migration of MediaWiki documentation
Closed, DeclinedPublic

Description

I'm Waldir Pimenta (User:Waldyrious, formerly User:Waldir) and I'm applying to participate in Wikimedia's project Complete migration of MediaWiki documentation in the 2024 edition of the Google Season of Docs program.

I have been a Wikimedian since 2005, and have both contributed software patches to the MediaWiki core repository, and authored/edited written content in the MediaWiki documentation. MediaWiki.org is my fifth most-edited wiki, with over two thousand edits so far. I am a trusted member of the technical community, having been granted administrator role in mediawiki.org, and I regularly participate in the Wikimedia Hackathons since 2012.

I've been interested in MediaWiki documentation for many years now, and have even planned major content reorganization efforts, as can be seen in User:Waldyrious/Docs. I haven't worked specifically in the content migration from Meta, but I did collect notes about that in User:Waldyrious/meta2mw, back in 2012 — in fact, those notes were originally a major focus of my plans for the MediaWiki documentation, and the largest section of main user page. I also have worked as a software engineer in the past, and now as a technical writer, so I believe it's fair to say that I have the skills, the contextual knowledge, and the personal interest to pursue this project successfully.

I am currently employed full-time as a technical writer, so my availability would be limited to 4–6 hours per week. That said, I am confident that with my existing experience, specific knowledge of the project domain, and ability to work autonomously as well as coordinating with the project mentors, it is possible to complete the project well within the GSoD timeline.

My preliminary plans for the work are:

  • Communicating with the project's mentors and other relevant community members to establish expectations and sketch an initial work plan and timeline
  • Assessing in more detail the scope of the content covered by the project: which pages to migrate, the depth of their content, any existing translations, and their currentness.
  • Preparing mechanisms to track the progress of the migration (e.g. Phabricator tasks, a workboard, a tracking spreadsheet, etc.)
  • Reviewing existing tasks, discussions and project pages (e.g. T181380, Project:MediaWiki documentation on Meta-Wiki) to collect additional context or subtasks
  • Actually migrating the content, with the appropriate rewriting/updating/reorganization
    • If appropriate, use MediaWiki's export/import feature to directly move any content that has compatible licensing (or isn't complex enough to warrant licensing concerns), as a way to preserve the page history
  • Marking the migrated pages on Meta with banners indicating their historical status and pointing to the new location at mediawiki.org
  • If time permits: Fixing any links to the old pages to point to the new locations
  • Announcing the outcome to the Wikimedia technical community in the appropriate venues (Diff blog, mailing lists, Tech News, etc.)

For this work, I propose a budget of $8,000.

Event Timeline

apaskulin subscribed.

Hi @waldyrious, Thanks for your interest in Season of Docs! Do you think your availability would give you enough time to review and organize the remaining Wikimedia-specific help pages on Meta, including updating landing pages such as Help:Contents? Also, the budget for the project has already been fixed at $12,000; let me know if that works for you.

Hey there! I was deliberately conservative in my time availability estimate (and therefore also the budget) because I didn't want to overcommit and sacrifice my family life due to combining this with my full-time job. I am reasonably confident that the amount of time I have planned to use should be sufficient to complete the project, including some restructuring of the pages on Meta, but I would be able to expand the time dedication if it turns out to be necessary (I can also take a couple months off on a leave from my day job, if it turns out to be appropriate). Such decisions would depend on a deeper initial assessment of the workload, as well as the recommendations from the people who have prepared the project, and certainly know more about the necessary commitment than I do! :)

As for the budget, I am happy to adhere to the previously fixed value (which I had assumed to be more of a guidance or maximum).

Perfect, thanks! I'm moving your proposal into the Reviewed column. We'll let you know on May 10 if we've selected your proposal.

Hi @waldyrious, Thanks for submitting this proposal! In the end, we decided to go with someone with more availability, but yours was definitely one of our top proposals. We hope you’ll consider applying next year. See you around the wikis!

I perfectly understand, @apaskulin! Although I was enthusiastic about the chance to contribute to wrap up this long overdue content migration/unification, I must admit I'm also slightly relieved that this work will still happen without me having to figure out how to make the timelines work out! ^^

If I may leave you a suggestion, maybe next year consider including also projects that could be completed more comfortably in part-time (with the appropriate budget adjustments, of course), as people like me who are employed full-time would be then able to apply more confidently. Maybe even put out calls for participation in the project proposal definition phase, in e.g. the Tech News newsletter, Diff, the Wikimedia Hackathon channel, etc., so that people who are interested in the topic of MediaWiki documentation could help surface needs and potential project ideas.

If I may leave you a suggestion, maybe next year consider including also projects that could be completed more comfortably in part-time (with the appropriate budget adjustments, of course), as people like me who are employed full-time would be then able to apply more confidently. Maybe even put out calls for participation in the project proposal definition phase, in e.g. the Tech News newsletter, Diff, the Wikimedia Hackathon channel, etc., so that people who are interested in the topic of MediaWiki documentation could help surface needs and potential project ideas.

This is a great suggestion! Thanks! I've added this to my notes for next year.