<3 Very pretty. One step closer to T26070 ...
Nice to see global site search <https://global-search.toolforge.org/> and
codesearch <https://codesearch.wmcloud.org/search/> featured prominently;
more people should know about them.
On Wed, Jun 15, 2022 at 10:07 AM Birgit Müller <bmueller@wikimedia.org>
wrote:
> Hi All,
>
> We are happy to announce the launch of the Wikimedia Developer Portal
> <https://developer.wikimedia.org/> - a centralized entry point for
> finding technical documentation and community resources across Wikimedia’s
> key technical areas.
>
>
> The Developer Portal project
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal> 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
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/History>,
> designing a content strategy
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Content_strategy>
> and user journeys
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal?tableofcontents=1#User_journeys>
> to help people navigate and achieve their tasks, technical implementation
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Implementation>
> of the portal, developing a documentation review process
> <https://www.mediawiki.org/wiki/Documentation/Review_template>, and
> updating key documents.
>
>
> Wikimedia’s technical documentation spans a wide range of technologies, is
> distributed (and often duplicated) across mediawiki
> <https://www.mediawiki.org/wiki/MediaWiki>, wikitech
> <https://wikitech.wikimedia.org>, 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 <https://www.mediawiki.org/wiki/Localisation>, Communication
> <https://www.mediawiki.org/wiki/Communication>, Cloud Services
> introduction
> <https://wikitech.wikimedia.org/wiki/Help: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 <https://meta.wikimedia.org/wiki/User:APaskulin_(WMF)>,
> Andre <https://meta.wikimedia.org/wiki/User:AKlapper_(WMF)>, Bryan
> <https://meta.wikimedia.org/wiki/User:BDavis_(WMF)>, Sarah R
> <https://meta.wikimedia.org/wiki/User:SRodlund_(WMF)>, Tricia
> <https://meta.wikimedia.org/wiki/User:TBurmeister_(WMF)>).
>
>
> 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:
>
> -
>
> the members of WMF and WMDE engineering teams who participated in
> exploratory interviews early in the process,
> -
>
> everyone who provided feedback at Hackathon 2021 & 2022, via private
> messages, on the Project page
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Content_Draft/Feedback>
> or gave input or help on Phabricator tasks
> <https://phabricator.wikimedia.org/project/board/4941/query/all/>
> -
>
> Developers and community members who participated in multiple rounds
> of user testing
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/History#User_research_and_testing>
> -
>
> the Design Strategy team
> <https://design.wikimedia.org/strategy/index.html> at the Foundation
> for helping us with designing a research study and recruiting a diverse
> group of users to test the final version of the site
> -
>
> people who helped with key doc improvements and content reviews: Haley
> <https://meta.wikimedia.org/wiki/User:HLepp_(WMF)>, Kamil
> <https://meta.wikimedia.org/wiki/User:KBach-WMF>, Komla
> <https://meta.wikimedia.org/wiki/User:SSapaty_(WMF)>, Nick
> <https://meta.wikimedia.org/wiki/User:Quiddity_(WMF)>, Srishti
> <https://meta.wikimedia.org/wiki/User:SSethi_(WMF)>
> -
>
> translators and translatewiki.net community, especially Abijeet
> <https://meta.wikimedia.org/wiki/User:APatro_(WMF)>, Niklas
> <https://meta.wikimedia.org/wiki/User:Nlaxstrom-WMF>, and Verdy_p
> <https://translatewiki.net/wiki/User:Verdy_p>
> -
>
> People who helped us with steps towards production and deployment:
> Alexandros <https://meta.wikimedia.org/wiki/User:AKosiaris_(WMF)>,
> Andrew <https://meta.wikimedia.org/wiki/User:AndrewBogott_(WMF)>, Brian
> <https://meta.wikimedia.org/wiki/User:BKing_(WMF)>, Ryan
> <https://meta.wikimedia.org/wiki/User:RKemper_(WMF)>, Valentin
> <https://meta.wikimedia.org/wiki/User:VGuti%C3%A9rrez_(WMF)>
>
>
> 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
> <https://diff.wikimedia.org/2022/06/15/illuminating-pathways-to-technical-documentation/>.
> For more information about the technical implementation and design
> principles, please see the corresponding post on the techblog
> <https://techblog.wikimedia.org/2022/06/15/new-discovery-tool-for-technical-documentation/>.
> All key information is also available on the project page
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal> of
> the Developer Portal.
>
>
> Feedback, ideas and questions are more than welcome on the talk page of
> the project
> <https://www.mediawiki.org/wiki/Talk:Developer_Advocacy/Developer_Portal>.
> Let's keep discussions in one place. :-)
>
>
> Birgit & the Developer Portal project team
>
>
>
> --
> Birgit Müller (she/her)
> Director of Technical Engagement
>
> Wikimedia Foundation <https://wikimediafoundation.org/>
> _______________________________________________
> Wikimedia-l mailing list -- wikimedia-l@lists.wikimedia.org, guidelines
> at: https://meta.wikimedia.org/wiki/Mailing_lists/Guidelines and
> https://meta.wikimedia.org/wiki/Wikimedia-l
> Public archives at
> https://lists.wikimedia.org/hyperkitty/list/wikimedia-l@lists.wikimedia.org/message/OJNMNBMCMDZKSPBRUJLZZUFF6BNPYWAH/
> To unsubscribe send an email to wikimedia-l-leave@lists.wikimedia.org
--
Samuel Klein @metasj w:user:sj +1 617 529 4266
Nice to see global site search <https://global-search.toolforge.org/> and
codesearch <https://codesearch.wmcloud.org/search/> featured prominently;
more people should know about them.
On Wed, Jun 15, 2022 at 10:07 AM Birgit Müller <bmueller@wikimedia.org>
wrote:
> Hi All,
>
> We are happy to announce the launch of the Wikimedia Developer Portal
> <https://developer.wikimedia.org/> - a centralized entry point for
> finding technical documentation and community resources across Wikimedia’s
> key technical areas.
>
>
> The Developer Portal project
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal> 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
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/History>,
> designing a content strategy
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Content_strategy>
> and user journeys
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal?tableofcontents=1#User_journeys>
> to help people navigate and achieve their tasks, technical implementation
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Implementation>
> of the portal, developing a documentation review process
> <https://www.mediawiki.org/wiki/Documentation/Review_template>, and
> updating key documents.
>
>
> Wikimedia’s technical documentation spans a wide range of technologies, is
> distributed (and often duplicated) across mediawiki
> <https://www.mediawiki.org/wiki/MediaWiki>, wikitech
> <https://wikitech.wikimedia.org>, 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 <https://www.mediawiki.org/wiki/Localisation>, Communication
> <https://www.mediawiki.org/wiki/Communication>, Cloud Services
> introduction
> <https://wikitech.wikimedia.org/wiki/Help: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 <https://meta.wikimedia.org/wiki/User:APaskulin_(WMF)>,
> Andre <https://meta.wikimedia.org/wiki/User:AKlapper_(WMF)>, Bryan
> <https://meta.wikimedia.org/wiki/User:BDavis_(WMF)>, Sarah R
> <https://meta.wikimedia.org/wiki/User:SRodlund_(WMF)>, Tricia
> <https://meta.wikimedia.org/wiki/User:TBurmeister_(WMF)>).
>
>
> 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:
>
> -
>
> the members of WMF and WMDE engineering teams who participated in
> exploratory interviews early in the process,
> -
>
> everyone who provided feedback at Hackathon 2021 & 2022, via private
> messages, on the Project page
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Content_Draft/Feedback>
> or gave input or help on Phabricator tasks
> <https://phabricator.wikimedia.org/project/board/4941/query/all/>
> -
>
> Developers and community members who participated in multiple rounds
> of user testing
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/History#User_research_and_testing>
> -
>
> the Design Strategy team
> <https://design.wikimedia.org/strategy/index.html> at the Foundation
> for helping us with designing a research study and recruiting a diverse
> group of users to test the final version of the site
> -
>
> people who helped with key doc improvements and content reviews: Haley
> <https://meta.wikimedia.org/wiki/User:HLepp_(WMF)>, Kamil
> <https://meta.wikimedia.org/wiki/User:KBach-WMF>, Komla
> <https://meta.wikimedia.org/wiki/User:SSapaty_(WMF)>, Nick
> <https://meta.wikimedia.org/wiki/User:Quiddity_(WMF)>, Srishti
> <https://meta.wikimedia.org/wiki/User:SSethi_(WMF)>
> -
>
> translators and translatewiki.net community, especially Abijeet
> <https://meta.wikimedia.org/wiki/User:APatro_(WMF)>, Niklas
> <https://meta.wikimedia.org/wiki/User:Nlaxstrom-WMF>, and Verdy_p
> <https://translatewiki.net/wiki/User:Verdy_p>
> -
>
> People who helped us with steps towards production and deployment:
> Alexandros <https://meta.wikimedia.org/wiki/User:AKosiaris_(WMF)>,
> Andrew <https://meta.wikimedia.org/wiki/User:AndrewBogott_(WMF)>, Brian
> <https://meta.wikimedia.org/wiki/User:BKing_(WMF)>, Ryan
> <https://meta.wikimedia.org/wiki/User:RKemper_(WMF)>, Valentin
> <https://meta.wikimedia.org/wiki/User:VGuti%C3%A9rrez_(WMF)>
>
>
> 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
> <https://diff.wikimedia.org/2022/06/15/illuminating-pathways-to-technical-documentation/>.
> For more information about the technical implementation and design
> principles, please see the corresponding post on the techblog
> <https://techblog.wikimedia.org/2022/06/15/new-discovery-tool-for-technical-documentation/>.
> All key information is also available on the project page
> <https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal> of
> the Developer Portal.
>
>
> Feedback, ideas and questions are more than welcome on the talk page of
> the project
> <https://www.mediawiki.org/wiki/Talk:Developer_Advocacy/Developer_Portal>.
> Let's keep discussions in one place. :-)
>
>
> Birgit & the Developer Portal project team
>
>
>
> --
> Birgit Müller (she/her)
> Director of Technical Engagement
>
> Wikimedia Foundation <https://wikimediafoundation.org/>
> _______________________________________________
> Wikimedia-l mailing list -- wikimedia-l@lists.wikimedia.org, guidelines
> at: https://meta.wikimedia.org/wiki/Mailing_lists/Guidelines and
> https://meta.wikimedia.org/wiki/Wikimedia-l
> Public archives at
> https://lists.wikimedia.org/hyperkitty/list/wikimedia-l@lists.wikimedia.org/message/OJNMNBMCMDZKSPBRUJLZZUFF6BNPYWAH/
> To unsubscribe send an email to wikimedia-l-leave@lists.wikimedia.org
--
Samuel Klein @metasj w:user:sj +1 617 529 4266