Talk:Wikimedia Technical Documentation Team

Welcome!
Hi, all! Welcome to the team page for the newly formed Wikimedia Foundation Technical Documentation Team. Over the next few weeks, we'll be working to set up our team practices and plan our upcoming work. APaskulin (WMF) (talk) 21:35, 14 June 2023 (UTC)

Tech Docs update June 16, 2023
Hi everyone, This is the first in a series of twice-monthly updates to share what the Tech Docs Team has been working on. For more details, you can follow along on our Phabricator workboard.


 * Documentation metrics dashboard
 * We continued building the underlying functionality for the MVP of the dashboard, including the ability to fetch and display lists of pages and support for left-to-right and right-to-left styles. We're working through some legal questions around open source licenses before we can publish the code, but we're hoping to have this issue resolved soon.


 * Team processes and practices
 * As a newly formed team, we began the process of setting up our team documentation, contact channels, and work management practices, including this page.


 * Content mapping and user journeys
 * We continued working on content mapping to identify missing landing pages for user journeys, focusing on analyzing landing pages for using open data and hosting tools.


 * Decision records
 * We started developing a standardized template for decision records. If you have feedback on the proposed template or on decision records in general, we'd love to hear from you on T338835.


 * Pywikibot documentation updates
 * As part of an ongoing project to update and streamline the Pywikibot documentation, we completed updates to the Pywikibot on Toolforge tutorial.


 * Wikimedia Developer Portal
 * A big thanks to User:Sushrith Bogi for fixing a link, and to User:BDavis (WMF) for setting up a CI check to improve the contributor experience.

APaskulin (WMF) (talk) 22:37, 16 June 2023 (UTC)

Tech Docs update June 30, 2023
Hi all, It's the last day of the quarter and the last day of the 2022-2023 fiscal year! Here's an update on what the Tech Docs Team has been working on recently. For more details, you can follow our Phabricator workboard.


 * Documentation metrics dashboard
 * We started work on opening the dashboard view and fetching metrics, including handling for namespaces, SQL queries, and rate limiting. We completed the legal review process to choose an open-source license for the project, so we're looking forward to setting up the code repository.


 * Decision records
 * We completed edits to the standardized template for decision records. It is now available at Documentation/Decision records. Feedback on the talk page and edits welcome!


 * API Portal, AQS 2.0, and RESTBase sunsetting
 * We continued support for documentation strategy for the AQS 2.0 and RESTBase sunsetting projects, and for API documentation in general. We updated the API Portal with a new structure that supports multiple APIs.


 * Cloud Services documentation information architecture
 * We completed initial designs for task-focused landing pages for the Cloud Services collection and a revised collection structure for the Toolforge docs.


 * Team processes and practices
 * We published a list of active projects to our team wiki page and made progress on defining project management processes and team lead role responsibilities.

APaskulin (WMF) (talk) 22:46, 30 June 2023 (UTC)

Tech Docs update July 14, 2023
Hi all, It's a new fiscal year and a new quarter! Here's an update on what the Tech Docs Team has been working on recently. For more details, you can follow our Phabricator workboard.


 * Documentation metrics dashboard
 * We set up the code repository for the dashboard on Wikimedia GitLab, including project documentation and decision records, and started adding pageview statistics to the default view.


 * Team processes and practices
 * We reviewed the drafts of our approach to projects, advising, and the team lead role and published the resulting processes to our team page on Office Wiki.


 * Cloud Services documentation information architecture
 * We re-scoped the remaining work on this project to focus on information architecture updates. We completed drafts of the proposed information architecture for both the Cloud Services and Toolforge collections and reviewed them within the team in preparation for requesting feedback from stakeholders.


 * Pywikibot workshop materials
 * As part of our work documenting workshop materials for Pywikibot, we completed and published reusable templates for creating workshop handbooks and self-study guides. Edits and feedback are welcome!


 * Conceptual framework for landing pages
 * We defined the scope of this project, updated the task in Phabricator, and moved it to in progress.


 * mediawiki.org project pages update
 * We kicked off a new project to update the pages in the project namespace here on mediawiki.org, starting by researching the existing pages and navigation.

APaskulin (WMF) (talk) 21:03, 14 July 2023 (UTC)

Tech Docs update July 28, 2023
Hi all, Here's the latest update from the Tech Docs Team. For more details, you can follow our Phabricator workboard.


 * Pywikibot workshop materials
 * This project is now complete! There are now templates and tasks in place to complete the remaining handbooks and self-study guides. These tasks would be great medium-sized documentation projects for anyone interested in working on new pages.


 * Cloud Services documentation information architecture
 * We completed the design document for restructuring the Toolforge and Cloud Services docs and shared it with the Cloud Services Team for feedback. We also continued work on the content audit for the Toolforge docs.


 * Team processes and practices
 * We published processes for handling ongoing maintenance responsibilities and task intake on Office Wiki.


 * Decision records
 * We updated the decision record template with quick and complete options to support different size decisions. Comments and edits welcome!


 * Wikimedia Developer Portal
 * Thanks to User:Dolphyb and User:BDavis (WMF) for submitting patches! The SignIt Firefox Extension is now a featured JavaScript project for contributors.

APaskulin (WMF) (talk) 23:06, 28 July 2023 (UTC)