[Localization] Contribution support request

[LittleWhite]

Hello,

For my case, I find that it is easy to miss important info about the 
process (because, you have to follow two pages (Gerrit and Qt 
localization, and in the latter one, the Qt Creator section refers some 
part of the Qt section). I just noticed that a link to the Qt Creator 
translation README was added recently (in 
https://wiki.qt.io/Qt_Localization), which is a good thing.
One of the most cryptic part, was this:

 > Note that unlike the rest of Qt, the translations still use a 
forward-merging branch model, so you should target the oldest branch you 
find still relevant first

First, it is in the "Instructions for Qt", so, not sure if I should 
follow it, or not (I mean, when contributing to Qt Creator). 
Additionally, since I was also following the Gerrit page, I first write 
my push command to target refs/for/dev. I got an error. So, as I 
fallback, I targeted master. I also find it cryptic because you have to 
follow recent Qt Creator development to understand that this branch is 
the (actually) 11.0. I mean, what would be the way to get this info? when:

- you did not receive the last release email, because you were not yet 
in the mailing list

- on this page: 
https://code.qt.io/cgit/qt-creator/qt-creator.git/about/share/qtcreator/translations/README.md 
, it will display master (of course). But if you use the top down branch 
selector, good luck to find 11.0 in the list, since it is ordering it 
alphabetically.

- I looked at previous contribution on the file I was translating and it 
seemed to target master

For beginners, the forward-merging branch model may not make that much 
sense.

One way to fix that would be to find a command that would output branch 
it would be. Not sure if it is possible, though.

(This is my point of view and my struggles during the process. Now that 
I have made it through once, and thanks for the help you gave me during 
my contribution, some part are clearer and make much sense. I hope this 
can help to improve the documentation.)

Best regards,



Le 13/09/2023 à 11:22, Oswald Buddenhagen a écrit :
> On Wed, Sep 13, 2023 at 09:03:30AM +0200, Kristóf Kiszel wrote:
>> What is the correct method to handle this, and push new changes to a
>> previous commit?
>>
> that's explained in 
> https://wiki.qt.io/Gerrit_Introduction#Updating_a_Contribution_With_New_Code 
> - you should have arrived there if you recursively followed the links 
>   from https://wiki.qt.io/Qt_Localization (which i presume you read, 
> as   you're here).
>
> a question for the wider audience: literally every recent external 
> translation contribution targeted dev/master despite the wiki being 
> (imo) very clear about this being wrong, in at least two places.
> this wasn't happening before, so i wonder whether there is a 
> systematic problem i missed, or is it just coincidence?
>
> _______________________________________________
> Localization mailing list
> Localization at qt-project.org
> https://lists.qt-project.org/listinfo/localization