Super excited!

On Wed, 15 Jun 2022, 15:07 Birgit Müller, <bmueller@wikimedia.org> wrote:

Hi All,

We are happy to announce the launch of the Wikimedia Developer Portal - a centralized entry point for finding technical documentation and community resources across Wikimedia’s key technical areas. 


The Developer Portal project is part of a broader initiative to improve the discoverability and overall quality of key technical documentation. Work on this project began in July 2020 and included research and feedback rounds, designing a content strategy and user journeys to help people navigate and achieve their tasks, technical implementation of the portal, developing a documentation review process, and updating key documents. 


Wikimedia’s technical documentation spans a wide range of technologies, is distributed (and often duplicated) across mediawiki, wikitech, code repositories or other places, might or might not be up-to-date, and serves multiple audiences. 


This complex landscape can make it hard to find the information you need. The goal of the Developer Portal is to make it easier for developers and other technical contributors to:

  • Find the key documentation they need for common developer tasks.

  • Discover available tools and technologies.

  • Learn how to get started in Wikimedia technical areas.

At its core, the Developer Portal is a navigation tool. It is an index of categorized links to key sources of technical information. These sources are hosted primarily on wikis—the portal itself contains no actual documentation. 

A major part of this project includes reviewing and updating the documents linked from the Developer Portal - the actual documentation (examples: Localisation, Communication, Cloud Services introduction). This work will continue over the next year while also investigating how to improve and scale the process.  


The Developer Portal is a project by the Developer Advocacy team within the Technical Engagement group at the Wikimedia Foundation and has been developed by a project team of technical writers, engineers, and developer advocates (Alex, Andre, Bryan, Sarah R, Tricia). 


The long term goal is to step-by-step move towards a future where Wikimedia’s technical documentation is discoverable, accurate, standardized, and continuously updated. Yes, this is big :-) and yes, it will take a while. Hope you join us in realizing this collective effort of making it easier for people to contribute to the code and technical spaces. 


Thank you <3


This project would not have been possible without the support, knowledge, ideas and feedback of many! A huge thanks to:


We hope that this new resource will be fun to explore and ultimately be useful for your work. 


If you are interested in learning more about the thinking behind the user journey design for the Developer Portal, please see the blog post on Diff. For more information about the technical implementation and design principles, please see the corresponding post on the techblog. All key information is also available on the project page of the Developer Portal. 


Feedback, ideas and questions are more than welcome on the talk page of the project. Let's keep discussions in one place. :-)


Birgit & the Developer Portal project team



--
Birgit Müller (she/her)
Director of Technical Engagement

_______________________________________________
Cloud mailing list -- cloud@lists.wikimedia.org
List information: https://lists.wikimedia.org/postorius/lists/cloud.lists.wikimedia.org/