Hi!
Will the content of this portal be translatable? How will the translation process work?
There are a lot of links in the email. It's possible that the answer to my question is somewhere in these links. I tried clicking some of them and couldn't find it.
-- Amir Elisha Aharoni · אָמִיר אֱלִישָׁע אַהֲרוֹנִי http://aharoni.wordpress.com “We're living in pieces, I want to live in peace.” – T. Moore
בתאריך יום ו׳, 17 בדצמ׳ 2021 ב-9:10 מאת Andre Klapper < aklapper@wikimedia.org>:
Hej hej,
as you may remember from previous https://lists.wikimedia.org/hyperkitty/list/wikitech-l@lists.wikimedia.org/message/YIIXKY455DCOFIF63BARD2BJEGIC7YF3/ posts https://lists.wikimedia.org/hyperkitty/list/wikitech-l@lists.wikimedia.org/message/XBNIH2Q3WJG5ECZXVBKGNCIB6GJ4KHX4/, we (Alex https://meta.wikimedia.org/wiki/User:APaskulin_(WMF), Bryan https://meta.wikimedia.org/wiki/User:BDavis_(WMF), Sarah https://meta.wikimedia.org/wiki/User:SRodlund_(WMF), Tricia https://meta.wikimedia.org/wiki/User:TBurmeister_(WMF), and me https://meta.wikimedia.org/wiki/User:AKlapper_(WMF)) are working on a developer portal for technical documentation https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal and updating key technical documents. The goal is to make it easier for everyone to find the help and information you need about the technical side of MediaWiki software and Wikimedia projects and to improve the overall quality and discoverability of technical documentation.
I'm going to share what has happened over the last months (also see the general schedule https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal#Timeline ).
Regarding the technical stack, we decided on a platform https://phabricator.wikimedia.org/T287175. Its work-in-progress codebase is in Gerrit https://gerrit.wikimedia.org/g/wikimedia/developer-portal/ and there might be a demo server https://phabricator.wikimedia.org/T297800 soon. This is the technical scaffold; actual content will be added when we get closer to launching in a few months (see the corresponding task graph https://phabricator.wikimedia.org/T261510 for work to sort out before launching).
We defined core audiences https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal#Core_audiences and had nine user tests completed https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Call_for_feedback_and_testing so far. The feedback helped iterate on the Developer Portal content layout draft prototype https://apaskulin.github.io/wmf-dev-portal-draft/ (which evolved from a unified to a multipage approach).
We are also in the process of reviewing and improving many key technical documentation pages (which will get linked from the developer portal). These updates and accuracy checks are based on a review checklist https://www.mediawiki.org/wiki/Documentation/Review_template. The checklist may also be helpful for anyone else interested in good technical documentation. For planning documentation review work, we use a Phabricator workboard https://phabricator.wikimedia.org/project/profile/5409/; you can also find the list of key pages on the project wiki page https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal#Key_landing_pages .
To get involved, sign up https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal/Call_for_feedback_and_testing#We_could_use_your_help! to participate in user testing for the developer portal. For questions and feedback, leave us a comment on the project talk page https://www.mediawiki.org/wiki/Talk:Developer_Advocacy/Developer_Portal.
All these efforts are part of the goal to have discoverable docs and paths to entry https://www.mediawiki.org/wiki/Wikimedia_Technology/Annual_Plans/ERF_OKR:_Tech_Community_Building .
Cheers, andre
--
Andre Klapper (he/him) | Bugwrangler / Developer Advocate https://blogs.gnome.org/aklapper/ http://blogs.gnome.org/aklapper/
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org To unsubscribe send an email to wikitech-l-leave@lists.wikimedia.org https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/