Abstract-Wikipedia June 2024

abstract-wikipedia@lists.wikimedia.org

1 participants
2 discussions

Newsletter #160: New Type - Integer
by Denny Vrandečić 21 Jun '24

21 Jun '24

The on-wiki version of this newsletter can be found here: https://www.wikifunctions.org/wiki/Wikifunctions:Status_updates/2024-06-20 -- New Type: Integers We are happy to announce a new Type: Integer <https://www.wikifunctions.org/view/en/Z16683>. Integers are the whole positive and negative numbers, and zero. <https://www.wikifunctions.org/wiki/File:Background_azul_n%C3%BAmeros_entero…> Integers will allow us to have functions that increase our coverage of mathematical functions, *e.g.* our current subtraction function <https://www.wikifunctions.org/view/en/Z13569> floors at zero. This will also help us with figuring out how to deal with overlapping Types, since the Integer <https://www.wikifunctions.org/view/en/Z16683> and the Natural numbers <https://www.wikifunctions.org/view/en/Z13518> Types are closely related. The Integer Type is also our first complex Type to be introduced since launch. A complex Type is a Type that has more than a single Key, and thus benefits particularly from the parser and renderer systems. We know that the parser and renderer makes them a bit slower. We are working on improving the system performance. We invite you to build functions with the new type and are excited to see how it will work. Recent Changes in the software We're about to finish the Quarter (April–June 2024), and so a lot of the work recently (and for the next two) is around completing those eight Epics <https://www.wikifunctions.org/wiki/Wikifunctions:Status_updates/2024-05-03>, and setting us up for the next Quarter (July–September 2024), which we have planned out this week. We will report on the results of the planning soon. As part of our long-term work on Type support, when prompted to enter a "enum" Type (*i.e.*, one with Identity values, like Z16098/Gregorian calendar month <https://www.wikifunctions.org/view/en/Z16098>), you'll have a select drop-down control, instead of a text box where you have to search or know what the valid options are (T366628 <https://phabricator.wikimedia.org/T366628>). We improved the front-end experience when creating Type converters related to Identity keys, and generally cleaned up the code in this area (T367159 <https://phabricator.wikimedia.org/T367159>), and made it more possible to use the UI to create Type converters rather than needing to use the API ( T367168 <https://phabricator.wikimedia.org/T367168>). We split out the rights for editing type converters, with everyone able to create and edit them when new or unconnected, but (like with Functions) having them locked-down once they're 'live', so that people can't accidentally break all uses of a Type (T367270 <https://phabricator.wikimedia.org/T367270>). You can see the updated documentation on our User rights documentation <https://www.mediawiki.org/wiki/Help:Wikifunctions/User_rights>. We also updated the definitions of Z46/Type converter to code <https://www.wikifunctions.org/view/en/Z46> and Z64/Type converter from code <https://www.wikifunctions.org/view/en/Z64> to mark their 'identity' keys (Z46K1 and Z64K1 respectively) as identity keys via setting Z3K4/is identity <https://www.wikifunctions.org/view/en/Z3> to true (T359233 <https://phabricator.wikimedia.org/T359233>). On the Epic related to improving our tests (T363389 <https://phabricator.wikimedia.org/T363389>), we continued our work on re-writing our browser test suites, and have now completed all but the last suite, related to connecting and disconnecting Testers and Implementations from Functions, which we will work on next (T349836 <https://phabricator.wikimedia.org/T349836>). Related to the Epic for giving meta-data for function sub-calls (T363384 <https://phabricator.wikimedia.org/T363384>), we added front-end support for showing the information (T363396 <https://phabricator.wikimedia.org/T363396>), and we're preparing to deploy the latest version of the back-end services with this information (T366498 <https://phabricator.wikimedia.org/T366498>), and we hope to enable this feature soon (T366829 <https://phabricator.wikimedia.org/T366829>). The last task this Quarter for better UX related to language (T363383 <https://phabricator.wikimedia.org/T363383>) was to make it so that short descriptions on Objects will now wrap their contents if someone adds a long word with no character breaks, rather than expanding into the content ( T360510 <https://phabricator.wikimedia.org/T360510>). In preparation for next Quarter's work, as part of the Wikimedia Foundation Annual Plan for 2024–25 <https://meta.wikimedia.org/wiki/Wikimedia_Foundation_Annual_Plan/2024-2025/…> to "*enable [cross-wiki] Wikifunctions calls on at least one smaller language Wikipedia*" (WE2.4 <https://meta.wikimedia.org/wiki/Wikimedia_Foundation_Annual_Plan/2024-2025/…>), we moved our very early prototype code for making Wikifunctions calls into its own extension, WikifunctionsClient <https://gerrit.wikimedia.org/g/mediawiki/extensions/WikifunctionsClient>. Expect more on this soon! Beyond the Quarterly work, we landed a few bug fixes and improvements. We fixed a bug where new (empty) Objects would run their Renderer function, even though no input had been given yet (T367157 <https://phabricator.wikimedia.org/T367157>). We improved the accessibility of close-dialog controls, using a better, more specific message for screen readers. We updated support for several languages in Wikifunctions, correcting codes to align with the industry standard BCP47 codes as the primary codes and relegating the MediaWiki bespoke non-standard ones to secondary. This means that Z1755/sgs <https://www.wikifunctions.org/view/en/Z1755> now has 'bat-smg' as secondary, rather than the other way around (T360672 <https://phabricator.wikimedia.org/T360672>); similarly, Z1231/de-x-formal <https://www.wikifunctions.org/view/en/Z1231> now has 'de-formal' (T360673 <https://phabricator.wikimedia.org/T360673>) and Z1664/ro-cyrl-md <https://www.wikifunctions.org/view/en/Z1664> has 'ro' (T360674 <https://phabricator.wikimedia.org/T360674>); and Z1508/als <https://www.wikifunctions.org/view/en/Z1508> has had the old Z1405 'gsw' object (T360675 <https://phabricator.wikimedia.org/T360675>) and Z1726/egl <https://www.wikifunctions.org/view/en/Z1726> the old Z1750 'eml' object ( T360678 <https://phabricator.wikimedia.org/T360678>) merged in, with the old ones deleted. Some of the tasks previously worked on as "Fix-It" to address technical debt landed. We have tweaked many parts of our front-end testing code to reduce the number of warnings from the Vue framework, and so make it easier to spot actual issues (T325412 <https://phabricator.wikimedia.org/T325412>). We have audited all the inline "TODO" comments in our PHP code, and ensured that they are still relevant, and if so have a Phabricator task (T296401 <https://phabricator.wikimedia.org/T296401>). We found and fixed a long-standing typo in our maintenance database cache deletion code which we think should improve language-related bugs (T343164 <https://phabricator.wikimedia.org/T343164>, T357702 <https://phabricator.wikimedia.org/T357702>), and added some more testing to avoid this issue in future. We led the pack across Wikimedia, upgrading our code linting tools (stylelint-config-wikimedia to 0.17.2, and eslint-config-wikimedia to 0.28.2), which included migrating from explicit to arrow function style. This is the new Wikimedia-wide standard, now that Internet Explorer support has finally been dropped. Our thanks to our colleague Ed Sanders, principal for the Editing team, for his leadership and help in this regard. We, along with all Wikimedia-deployed code, are now using the latest version of the Codex UX library, v1.7.0, as of this week. It should have no user-visible changes on Wikifunctions, so please comment on the Project chat or file a Phabricator task if you spot an issue. Function of the Week: following month in the Igbo calendar Last week, we introduced <https://www.wikifunctions.org/wiki/Wikifunctions:Status_updates/2024-06-13> the Igbo calendar month Type <https://www.wikifunctions.org/view/en/Z16927>, and today we have half a dozen Functions with that Type. One of the basic Functions for calendars is a Function to figure out the following <https://www.wikifunctions.org/view/en/Z16972> and previous months <https://www.wikifunctions.org/view/en/Z16990> given a certain month. Both of these Functions exist now for the Igbo calendar months in Wikifunctions. The following month function <https://www.wikifunctions.org/view/en/Z16972> offers six tests, including the edge case of the last month of the calendar year being followed by the first one <https://www.wikifunctions.org/view/en/Z16989>. The Function has three implementations, and each of them works slightly differently: - One in Python <https://www.wikifunctions.org/view/en/Z17016>, which uses the fact that we convert the months to numbers. It first checks whether the input argument is the last month, 13 (the Igbo calendar has 13 months), in which case it returns the first one, or else it just adds 1. - One in JavaScript <https://www.wikifunctions.org/view/en/Z16982>, which also uses the fact that we convert the months to numbers, adds 1, but then calculates modulo 13 in order to deal with the overflow. - One as a composition <https://www.wikifunctions.org/view/en/Z16980>, which turns the input month into a number <https://www.wikifunctions.org/view/en/Z16973>, increments the number by one <https://www.wikifunctions.org/view/en/Z13578>, and turns that result back into a month <https://www.wikifunctions.org/view/en/Z16955>. Because that last Function is robust against an overflow and underflow by one, we relegate taking care about the overflow to that Function. Thanks to the community for diligently creating new Functions when a new Type comes out! You are amazing!

1 0

Newsletter 159: New Type: Igbo calendar months
by Denny Vrandečić 13 Jun '24

13 Jun '24

New Type: Igbo calendar months We are happy to announce another new Type this week: an enumeration for the thirteen months of the Igbo calendar <https://en.wikipedia.org/wiki/Igbo_calendar> (Igbo calendar month (Z16927) <https://www.wikifunctions.org/view/en/Z16927>). <https://www.wikifunctions.org/wiki/File:Nsibidi_moon.jpg>The symbol for the Moon in Nsibidi <https://en.wikipedia.org/wiki/Nsibidi>, an Igbo system in use since the 5th century CE The Type follows the Type proposal <https://www.wikifunctions.org/wiki/Wikifunctions:Type_proposals/Igbo_calend…> led by Dolphyb <https://www.wikifunctions.org/wiki/User:Dolphyb>. We created the thirteen months of the Igbo calendar: Ọnwa Mbụ <https://www.wikifunctions.org/view/en/Z16928>, Ọnwa Abụo <https://www.wikifunctions.org/view/en/Z16929>, Ọnwa Ife Eke <https://www.wikifunctions.org/view/en/Z16930>, Ọnwa Anọ <https://www.wikifunctions.org/view/en/Z16931>, Ọnwa Agwụ <https://www.wikifunctions.org/view/en/Z16932>, Ọnwa Ifejiọkụ <https://www.wikifunctions.org/view/en/Z16933>, Ọnwa Alọm Chi <https://www.wikifunctions.org/view/en/Z16934>, Ọnwa Ilo Mmụọ <https://www.wikifunctions.org/view/en/Z16935>, Ọnwa Ana <https://www.wikifunctions.org/view/en/Z16936>, Ọnwa Okike <https://www.wikifunctions.org/view/en/Z16937>, Ọnwa Ajana <https://www.wikifunctions.org/view/en/Z16938>, Ọnwa Ede Ajana <https://www.wikifunctions.org/view/en/Z16939>, and Ọnwa Ụzọ Alụsị <https://www.wikifunctions.org/view/en/Z16940>. A first function was also introduced, to check two Igbo months for equality <https://www.wikifunctions.org/view/en/Z16945>. We are looking forward to seeing more Type proposals <https://www.wikifunctions.org/wiki/Wikifunctions:Type_proposals> for calendar months, particularly for other calendar systems that are currently in use, and that are relevant to Wikipedia. In related news about new Types, we are still working on some final tasks that will enable the use of the (signed) integer Type. Presentation on Wikifunctions and Abstract Wikipedia in Munich Next Thursday, June 20, 2024, at 19:00 local time in Munich, Germany,, Kristbaum <https://www.wikifunctions.org/wiki/User:Kristbaum> will be presenting on Wikifunctions and Abstract Wikipedia. Attendance is free, but they ask for an informal registration either via Email or on the wiki page of the event: - WikiMUC: Sind Wikifunctions und Abstract Wikipedia die Zukunft der Wikipedia? <https://de.wikipedia.org/wiki/Wikipedia:WikiMUC/2024-06-20_Sind_Wikifunctio…> Recent Changes in the software We added the relevant rights for creating and editing instances of 'enum' Types like Z16098/Month <https://www.wikifunctions.org/view/en/Z16098> and Z16659/Sign <https://www.wikifunctions.org/view/en/Z16659> (T366610 <https://phabricator.wikimedia.org/T366610>). For now, alongside Type creation, these rights are reserved for Function Maintainers (and Wikifunctions staff); as always, all users can add and edit their labels, short descriptions, and aliases. We landed a few patches written last week as part of our regular "Fix-It" technical debt clearance initiative. We completed adding test coverage for our local Vue components <https://doc.wikimedia.org/cover/WikiLambda/lcov-report/>, now covering the CodeEditor one alongside the others (T358207 <https://phabricator.wikimedia.org/T358207>). We moved a handful of our legacy global functions out of the global JS namespace (T362925 <https://phabricator.wikimedia.org/T362925>). We updated some of our browser tests to use i18n-independent selectors, as part of work to make them more stable (T349836 <https://phabricator.wikimedia.org/T349836>). Function of the Week: do these charges electrostatically attract? Last week, we announced the Sign Type <https://www.wikifunctions.org/wiki/Wikifunctions:Status_updates/2024-06-06>, and I foolishly assumed that there wouldn’t be too many Functions for it. That was not meant as a challenge, but there are now more than a dozen Functions dealing with Signs. <https://www.wikifunctions.org/wiki/File:Opposites_attract.svg> In order to recognize that work we selected one of these as the Function of the Week: do these charges electrostatically attract? (Z16781) <https://www.wikifunctions.org/view/en/Z16781>, do these charges electrostatically attract? The Function takes two inputs of type Sign <https://www.wikifunctions.org/view/en/Z16659> and returns a Boolean <https://www.wikifunctions.org/view/en/Z40>. The inputs are the two charges which are checked for whether they attract each other, or not. As the saying goes, opposites attract <https://en.wikipedia.org/wiki/Opposites_Attract_(disambiguation)>: negative and positive attract each other, and if one value is negative and the other positive, the answer is true. In all other cases, it is false. The Function has four Tests, one with an example of where it attracts – negative and positive <https://www.wikifunctions.org/view/en/Z16783> – and three examples that do not: positive and positive <https://www.wikifunctions.org/view/en/Z16784>, positive and neutral <https://www.wikifunctions.org/view/en/Z16785>, and neutral and neutral <https://www.wikifunctions.org/view/en/Z16786>. For this Function, that’s a nice, balanced set of Tests. The Function currently has one Implementation, a composition <https://www.wikifunctions.org/view/en/Z16782>: it relies on multiplying the two input Signs <https://www.wikifunctions.org/view/en/Z16728> and checking whether the result of that multiplication is negative <https://www.wikifunctions.org/view/en/Z16662> using the same Sign <https://www.wikifunctions.org/view/en/Z16667> Function. When multiplying, you only get a negative result if one of the inputs is negative and the other is positive. And that’s what the Function is checking for. The implementation seems quite a bit smarter than the one I would have made: using if <https://www.wikifunctions.org/view/en/Z802> conditions to check whether one result is negative and the other positive, or the other way around, and return false <https://www.wikifunctions.org/view/en/Z42> otherwise. This is a Function I certainly did not have in mind when we introduced the Sign Type. I am happy to be surprised with the creativity of the community.

1 0

2024

2023

2022

2021

2020

Abstract-Wikipedia June 2024