Commit graph

3 commits

Author SHA1 Message Date
Tim Starling
1aeccebaf2 Use array_key_first()/array_key_last() in some places
Introduced in PHP 7.3. I used it to replace reset()/end() followed by
key() where the return value of reset() is not captured and internal
pointer iteration is not locally occuring.

I also used it in a couple of places when reset() is absent but
array_key_first() is semantically desired.

Change-Id: I750d3fa71420cbdca5fb00d82ac5ca40821769d4
2022-10-21 15:01:59 +11:00
Timo Tijhof
0ffe341629 language: Add missing @ingroup, subgroup "Languages" and ungroup files
== Ungroup file blocks

Remove `@ingroup` from `@file` blocks and keep only the class block.

This matches similar changes previously applied to API, Skins, Profile,
and ResourceLoader.

This helps make the API documentation easier to navigate.
E.g. Modules -> Language in the sidebar of
<https://doc.wikimedia.org/mediawiki-core/master/php/> as well as
<https://doc.wikimedia.org/mediawiki-core/master/php/group__Language.html>

These are currently cluttered with tons of duplicate entries for files
and classes both. We only need to group files that aren't also
documented as a class (e.g. message files, entry points, other scripts
or files that we mainly consider a data file). This has the helpful
side-effect that we don't encourage duplication of the class
description (or worse, place useful docs only in the file block), and
makes the class files consistently start with a mentally ignorable
block. Basically, unless there's something other than a class, don't
describe or group the file itself.

== Missing group

Various classes in this subtree were missing the `Language` group,
or were using different group from before T225756.

== Subgroup

For ease of navigation, move Converter subclasses to a group called
"Languages", which for documentation purposes is a subgroup of
"Language". The next commit does the same for Messages* files,
and Language subclasses (done separately for ease of review).

Change-Id: I301f471f86ba2dee924fece29a16dc3c20b5bebe
2022-06-28 17:12:46 -07:00
Timo Tijhof
051e127bdb language: Move l10n-related classes from /cache to /language
* Make the code easier to own and maintain by being part of a topical
  area of expertise rather than a generic catch-all bucket.
  This also helps Gerrit team dashboards, [[mw:Git/Reviewers]]
  subscription patterns, more meaningful component prefix for
  [[mw:Commit_message_guidelines]].

* Prep for possible CODEOWNERS adoption.

* Prep for T166010 to give us better PSR-4 namespaces that we won't
  have to break/migrate again shortly after for the above.

Bug: T225756
Change-Id: I62c701d574d2a79365b1c5350f92bef47770e3ce
2022-06-28 16:27:20 -07:00
Renamed from includes/cache/localisation/LocalisationCacheBulkLoad.php (Browse further)