Wikitech-l September 2024

wikitech-l@lists.wikimedia.org

43 participants
48 discussions

Article source code style guide
by Bináris 03 Dec '24

03 Dec '24

Hi, is there anywhere a $subject? My first question is: is it better to leave an empty line under section titles or not? I would like to see pros and cons. Is there a consensus for preferred way? (I think source code style guides are primarily within the scope of programmers and not in that of users without programming experience, that's why I ask here.) -- Bináris

4 6

Parsoid Read Views roll out on Bengali, Hindi, Pushto, and Turkish Wikivoyage this week
by C. Scott Ananian 27 Nov '24

27 Nov '24

Hello everyone, I am glad to inform you that as part of our continued rollout of Parsoid Read Views, Parsoid will be turned on this week as the default read views renderer on Bengali, Hindi, Pushto, and Turkish Wikivoyage. Here's the rationale <https://www.mediawiki.org/wiki/Parsoid/Parser%20Unification/Confidence%20Fr…> behind our confidence to roll-out this experimental feature and collect feedback. This is an opportunity for continued experimentation as we increase the number of wikis using Parsoid for read views. If this disrupts your workflow, don’t worry you can still opt out through a user preference or turn Parsoid off on the page you’re navigating in the Tools submenu, as described at the Extension:ParserMigration <https://www.mediawiki.org/wiki/Help:Extension:ParserMigration> page. To report bugs and issues, please look at our known issues <https://www.mediawiki.org/wiki/Special:MyLanguage/Parsoid/Parser%20Unificat…> documentation and if you found a new bug please create a phab ticket and tag the Content Transform Team in Phabricator <https://phabricator.wikimedia.org/project/view/5846>. There is more information about our roll-out strategy <https://www.mediawiki.org/wiki/Parsoid/Parser_Unification/Confidence_Framew…> available. Best regards, C. Scott Ananian <https://meta.wikimedia.org/wiki/User:CAnanian_(WMF)>, for the Content Transform Team >

2 5

[Google Season of Docs] Call for documentation projects and technical writers
by Alexandra Paskulin 27 Nov '24

27 Nov '24

Hi all, We’re excited to announce Wikimedia’s participation in Google Season of Docs! 🎉 For the first time since 2020, Wikimedia is applying for Google Season of Docs[1]: a program that provides grants to technical writers to work on documentation for open-source projects. This year, we’ll be selecting one Wikimedia documentation project and, if accepted by Google, hiring one technical writer to complete the project. For details about the program and how to apply, see the wiki page[2]. Here's how you can get involved: - [Until March 22] Propose a project, share feedback on a project, or volunteer to help support a project[3]. - [Until April 28] Apply as a technical writer. We highly encourage Wikimedians to apply! Even if you’re not a professional technical writer, we value experience working on wikis. Our goal is to use this program to improve MediaWiki.org and other Wikimedia technical documentation, supplementing the work done by volunteers and staff. We’re hoping to use this year’s edition as a model to expand the program to multiple projects in future years. Let's make this a successful season of documentation together! 📚 Best, - Alex and Onyinyechi [1] - https://developers.google.com/season-of-docs [2] - https://www.mediawiki.org/wiki/Season_of_Docs/2024 [3] - https://www.mediawiki.org/wiki/Season_of_Docs/2024#Volunteering_to_support_… -- Alex Paskulin Technical Writer Wikimedia Foundation

1 1

Changes to JavaScript documentation tools
by Alexandra Paskulin 12 Nov '24

12 Nov '24

Hi everyone, tl;dr The tools we use to document Wikimedia JavaScript code are changing. In the short term, you can read the complete MediaWiki core JavaScript docs using the 1.41 version[0] while we migrate to the new system[1]. If you use JavaScript documentation on doc.wikimedia.org, please share your feedback on wiki[2]. Wikimedia JavaScript codebases are switching from using JSDuck[3] to JSDoc[4] for documentation. Started in 2016, this migration is necessary because JSDuck is currently unmaintained and does not support the ES6 standard[5]. Several Wikimedia JavaScript codebases, including Vector and GlobalWatchlist, already use JSDoc, while several others, such as VisualEditor and MediaWiki core, still use JSDuck. The migration project consists of two parts: changing the codebases to support JSDoc and improving the usability of the JSDoc WMF theme. For more information, see phab:T138401[6]. == Migrating MediaWiki core to JSDoc == We are migrating MediaWiki core to JSDoc incrementally. While the migration is in progress, the master branch docs will be incomplete, containing only those modules that have been migrated. To read the old JSDuck docs, see the MediaWiki 1.41 docs[0]. To help with migration, choose a module from the list in phab:T352308[7], and follow the guide on phab:T138401[6] to translate the tags from JSDuck to JSDoc. == Migrating other codebases == You can find a list of codebases that use JSDuck on phab:T138401[6]. (Please add any that are missing.) To help migrate a codebase that uses JSDuck, follow the instructions to set up JSDoc[8], and use the guide in phab:T138401[6] to translate the tags from JSDuck to JSDoc. == Improving the JSDoc WMF theme == One of the biggest differences between JSDuck and JSDoc is the HTML interface for reading the docs. The WMF theme for JSDoc is not as full-featured as the JSDuck theme, but to support this migration, the Wikimedia Foundation Web, Design Systems, and Technical Documentation teams are working to prioritize and complete a set of improvements to the JSDoc theme, with the goal of releasing version 1 of jsdoc-wmf-theme in 2024. If you use JavaScript documentation on doc.wikimedia.org, please leave a comment on the JSDoc WMF theme talk page[2] and let us know how you use the docs and which features of the theme are the most important to you. Thank you for reading! Alex, Kamil, Jon, Roan, and Anne [0]: https://doc.wikimedia.org/mediawiki-core/REL1_41/js/ [1]: https://doc.wikimedia.org/mediawiki-core/master/js/ [2]: https://www.mediawiki.org/wiki/Talk:JSDoc_WMF_theme [3]: https://github.com/senchalabs/jsduck [4]: https://en.wikipedia.org/wiki/JSDoc [5] https://en.wikipedia.org/wiki/ECMAScript [6]: https://phabricator.wikimedia.org/T138401 [7]: https://phabricator.wikimedia.org/T352308 [8]: https://www.mediawiki.org/wiki/JSDoc -- Alex Paskulin Technical Writer Wikimedia Foundation

1 2

Can somebody help review this banana-i18n PR?
by psnbaotg 24 Oct '24

24 Oct '24

Hello all, I hope the maintainer of banana-i18n take a look at this PR (https://github.com/wikimedia/banana-i18n/pull/79), which is a fix for this task (https://phabricator.wikimedia.org/T359822). Thank you very much! Best, Diskdance

2 2

New Code of Conduct Committee members
by Amir Sarabadani 13 Oct '24

13 Oct '24

Hello everyone, The Committee has finished selecting its new members. The new committee candidates are (in alphabetical order): - Amir Sarabadani - Egbe Eugene Agbor (Eugene233) - Greg Grossmeier - Jayprakash12345 - Kamila Součková Auxiliary members will be (alphabetically): - Effie Mouzeli - Joris Darlington Quarshie - Martin Urbanec - MusikAnimal - SD0001 You can read more information about the members at [1]. List of changes from the last term: - Greg and Kamila will be joining the main committee. - Nuria is leaving the main committee - MusikAnimal is moving to the aux committee - Tony is leaving the aux committee This is not the final structure. According to the CoC [2], the current committee publishes the new members and calls for public feedback for *six weeks* and after that, the current committee might apply changes to the structure based on public feedback. Please let the committee know (via techconduct(a)wikimedia.org) if you have any concern regarding the members and its structure until *08 October 2024* and after that, the new committee will be in effect and will serve for a year. [1] https://www.mediawiki.org/wiki/Code_of_Conduct/Committee/Members/Candidates [2] https://www.mediawiki.org/wiki/Code_of_Conduct/Committee#Selection_of_new_m… -- Amir (he/him)

2 2

LL.wiki redirects? (ar.wiki, en.wiki, zh.wiki, &c)
by Samuel Klein 03 Oct '24

03 Oct '24

How do we maintain the redirects for LL.wiki for the two-letter language codes? I recall these were gifted as a set to wikimedia, but currently don't seem to work. We have en-wp.org for English, but it is also not configured properly: en-wp.org/TLDs redirects to en.wikipedia.org/TLDs and returns the error We could not find the above page on our servers. *Did you mean: /wiki/TLDs <https://en.wikipedia.org/wiki/ABCC11>* -- Samuel Klein @metasj w:user:sj +1 617 529 4266

3 3

Talk to the Search Platform / Query Service Team—October 2, 2024
by Guillaume Lederrey 02 Oct '24

02 Oct '24

Hello all! The Search Platform Team usually holds an open meeting on the first Wednesday of each month. Come talk to us about anything related to Wikimedia search, Wikidata Query Service (WDQS), Wikimedia Commons Query Service (WCQS), etc.! Feel free to add your items to the Etherpad Agenda for the next meeting. Details for our next meeting: Date: Wednesday, October 2, 2024 Time: 15:00-16:00 UTC / 08:00 PDT / 11:00 EDT / 17:00 CEST Etherpad: https://etherpad.wikimedia.org/p/Search_Platform_Office_Hours Google Meet link: https://meet.google.com/vgj-bbeb-uyi Join by phone: https://tel.meet/vgj-bbeb-uyi?pin=8118110806927 Have fun and see you soon! Guillaume -- *Guillaume Lederrey* (he/him) Engineering Manager Wikimedia Foundation <https://wikimediafoundation.org/>

1 1

Security and maintenance release: 1.39.9 / 1.41.3 / 1.42.2
by Sam Reed 30 Sep '24

30 Sep '24

1 0

Tech News 2024, week 40
by Nick Wilson (Quiddity) 30 Sep '24

30 Sep '24

Latest *tech news <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/News>* from the Wikimedia technical community. Please tell other users about these changes. Not all changes will affect you. Translations <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/News/2024/40> are available. *Updates for editors* - Readers of 42 more wikis <https://phabricator.wikimedia.org/T375401> can now use Dark Mode. If the option is not yet available for logged-out users of your wiki, this is likely because many templates do not yet display well in Dark Mode. Please use the night-mode-checker tool <https://night-mode-checker.wmcloud.org/> if you are interested in helping to reduce the number of issues. The recommendations page <https://www.mediawiki.org/wiki/Special:MyLanguage/Recommendations_for_night…> provides guidance on this. Dark Mode is enabled on additional wikis once per month. - Editors using the 2010 wikitext editor as their default can access features from the 2017 wikitext editor by adding ?veaction=editsource to the URL. If you would like to enable the 2017 wikitext editor as your default, it can be set in your preferences <https://meta.wikimedia.org/wiki/Special:Preferences#mw-input-wpvisualeditor…>. [1] <https://phabricator.wikimedia.org/T239796> - For logged-out readers using the Vector 2022 skin, the "donate" link has been moved from a collapsible menu next to the content area into a more prominent top menu, next to "Create an account". This restores the link to the level of prominence it had in the Vector 2010 skin. Learn more <https://www.mediawiki.org/wiki/Readers/2024_Reader_and_Donor_Experiences#Do…> about the changes related to donor experiences. [2] <https://phabricator.wikimedia.org/T373585> - The CampaignEvents extension provides tools for organizers to more easily manage events, communicate with participants, and promote their events on the wikis. The extension has been enabled <https://meta.wikimedia.org/wiki/Special:MyLanguage/CampaignEvents/Deploymen…> on Arabic Wikipedia, Igbo Wikipedia, Swahili Wikipedia, and Meta-Wiki. Chinese Wikipedia has decided <https://en.wikipedia.org/wiki/zh:Wikipedia:%E4%BA%92%E5%8A%A9%E5%AE%A2%E6%A…> to enable the extension, and discussions on the extension are in progress on Spanish Wikipedia <https://en.wikipedia.org/wiki/es:Wikipedia:Votaciones/2024/Sobre_la_pol%C3%…> and on Wikidata <https://www.wikidata.org/wiki/Wikidata:Project_chat#Enabling_the_CampaignEv…>. To learn how to enable the extension on your wiki, you can visit the CampaignEvents page on Meta-Wiki <https://meta.wikimedia.org/wiki/Special:MyLanguage/CampaignEvents>. - View all 22 community-submitted tasks that were resolved last week <https://meta.wikimedia.org/wiki/Tech/News/Recently_resolved_community_tasks> . *Updates for technical contributors* - Developers with an account on Wikitech-wiki should check if any action is required <https://wikitech.wikimedia.org/wiki/Wikitech/SUL-migration> for their accounts. The wiki is being changed to use the single-user-login (SUL) system, and other configuration changes. This change will help reduce the overall complexity for the weekly software updates across all our wikis. *In depth* - The server switch <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/Server_switch> was completed successfully last week with a read-only time of only 2 minutes 46 seconds <https://wikitech.wikimedia.org/wiki/Switch_Datacenter#Past_Switches>. This periodic process makes sure that engineers can switch data centers and keep all of the wikis available for readers, even if there are major technical issues. It also gives engineers a chance to do maintenance and upgrades on systems that normally run 24 hours a day, and often helps to reveal weaknesses in the infrastructure. The process involves dozens of software services and hundreds of hardware servers, and requires multiple teams working together. Work over the past few years has reduced the time from 17 minutes down to 2–3 minutes. [3] <https://lists.wikimedia.org/hyperkitty/list/wikitech-l@lists.wikimedia.org/…> *Meetings and events* - October 4–6: WikiIndaba Conference's Hackathon <https://meta.wikimedia.org/wiki/Special:MyLanguage/WikiIndaba_conference_20…> in Johannesburg, South Africa - November 4–6: MediaWiki Users and Developers Conference Fall 2024 <https://www.mediawiki.org/wiki/Special:MyLanguage/MediaWiki_Users_and_Devel…> in Vienna, Austria *Tech news <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/News> prepared by Tech News writers <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/News/Writers> and posted by bot <https://meta.wikimedia.org/wiki/Special:MyLanguage/User:MediaWiki_message_d…> • Contribute <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/News#contribute> • Translate <https://meta.wikimedia.org/wiki/Special:MyLanguage/Tech/News/2024/40> • Get help <https://meta.wikimedia.org/wiki/Tech> • Give feedback <https://meta.wikimedia.org/wiki/Talk:Tech/News> • Subscribe or unsubscribe <https://meta.wikimedia.org/wiki/Global_message_delivery/Targets/Tech_ambass…>.*

1 0

2026

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

Wikitech-l September 2024