Season of Docs/2024
Wikimedia is participating in Season of Docs 2024.
About Season of Docs
[edit]Google Season of Docs provides grants to technical writers to work on documentation for open-source software projects. Grants range from $5,000 to $15,000 USD depending on the project's budget.
In 2024, the Wikimedia Foundation will select one project and hire one technical writer to complete the project.
Project description
[edit]To learn about the documentation project we've chosen for Season of Docs, see Season of Docs/2024/Proposal.
Selected proposal
[edit]For this year's project, we've selected the proposal from Network-charles. Thanks to everyone who submitted a statement of interest!
Program timeline
[edit]February 26 | Done Start proposing and discussing project ideas. Technical writers start submitting statements of interest. |
March 22 | Done Deadline for project ideas and comments |
April 1 | Done Organization admins announce the selected project and submit the organization application |
April 10 | 🎉 We were accepted! Google announces accepted organizations |
April 28 | Done Deadline for technical writers to submit statements of interest |
May 10 | Done Organization admins announce selected technical writer |
May 20 | Done Technical writer starts working on the documentation project |
November 22 | Deadline for technical writer to complete the documentation project |
December 10 | Deadline for organization administrators to submit the final project evaluation |
December 13 | Google announces program results |
Project ideas
[edit]Proposed ideas |
---|
1. Complete migration of MediaWiki documentation[edit]Status: Accepted Open-source software project: MediaWiki Problem[edit]MediaWiki.org is the documentation wiki for MediaWiki: an open-source wiki platform used by Wikipedia and other Wikimedia projects, as well as by many other organizations and projects. Before MediaWiki.org existed, MediaWiki documentation was stored on a different wiki: Meta-Wiki (also called Meta). Since MediaWiki.org was established as the official wiki for MediaWiki documentation, most MediaWiki documentation pages on Meta have been moved to MediaWiki.org. However, there are still some pages on Meta that contain MediaWiki documentation. In most cases, these pages cannot be imported directly to MediaWiki.org because of licensing restrictions or because a corresponding page already exists on MediaWiki.org. This duplication makes it harder for users of MediaWiki to find the information they need and harder for documentation writers to maintain the docs, and as a result the Meta pages have often become very outdated. There is also some documentation on Meta that relates to MediaWiki but is specific to how MediaWiki is used on Wikimedia projects. This content should stay on Meta, while duplication between the two wikis should be reduced as much as possible. Here is an example of pages that show the correct separation of content between the two wikis:
Other examples include:
Scope[edit]The scope of this project includes:
Note that moving content from Meta to MediaWiki.org will usually involve re-writing the content instead of simply copying it due to licensing restrictions.
The scope of this project does not include:
Measuring success[edit]
Skills[edit]
See also[edit]2. Integrate new hooks system into the MediaWiki docs[edit]Status: Declined Open-source software project: MediaWiki Problem[edit]In 2020, MediaWiki 1.35 introduced a new system of handling hooks. Hooks are a powerful interface in MediaWiki that allows many extensions to interact with Wikipedia and other Wikimedia projects (as well as MediaWiki instances used by many other organizations and projects). Although widely used[1], this new hook system is not well integrated into hook documentation on MediaWiki.org. Improving documentation of the new hook system on will improve the completeness and accuracy of the MediaWiki docs and make it easier for the Wikimedia technical community to build tools that help maintain Wikimedia projects. Scope[edit]The scope of this project includes:
The scope of this project does not include:
Measuring success[edit]
Skills[edit]
See also[edit] |
Submitting a technical writer statement of interest
[edit]To apply for Season of Docs:
- Read the project proposal, and write a statement of interest using Google's statement of interest template. Make sure your statement of interest includes a detailed description of how you would approach the project, a timeline for your work, and a budget that follows Google's budget guidelines.
- If you don't have one already, create a Wikimedia account.
- Log in to Phabricator (Wikimedia's task tracking system) using your Wikimedia account by selecting the MediaWiki log-in option.
- Create a task with your statement of interest in the task description. Make sure your task is tagged with #Google Season of Docs 2024. Organization admins and others may ask questions by commenting on the task.
- Leave a comment on the talk page introducing yourself with a link to your task.
- Watch this page and configure your notification preferences to receive updates about the program.
Volunteering to support a project
[edit]Google offers a stipend of $500 USD to community members who help answer questions, review work, and generally take on a considerable mentorship or guidance role in the selected documentation project.[2] If you're interested in helping support a project, leave a comment on the talk page.
Organization administrators
[edit]Contact
[edit]Feel free to reach out to us with questions by leaving a comment on the talk page. We'll be posting official announcements to the talk page and updating this page as the program progresses.