Despite @kugel-'s documentation allergy ;-)
Not @kugel-'s, mine :-). To be specific, I really think this is implementation detail that users shouldn't worry about.
we do need to note that this happens to avoid regular issues being raised for the list being out of alphabetical order, but I agree we can skip explaining the algorithm.
We already did it in the previous PR: https://github.com/geany/geany/commit/a91a9c6ca17e5a7a163b095d5a9065afa7e8af...