Page 1 of 1

[TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-25, 11:12 UTC
by white
The options which can be chosen using the Sync button in Compare by Content mention finding inserted text within a line. I think this is worded wrong. It isn't about finding inserted text, it is about resynchronization (meaning searching for the same 3 letter sequence after a difference was found).

I suggest to change the following strings:
6219="&1 Find inserted text within a line (re-synchronize)"
6220="&2 Find inserted text only at spaces"
6221="&3 Find inserted text only at user-defined separators"
6222=" &Edit user-defined separators..."
6223="&0 Comparison at fixed positions (e.g. for tables)"
to:
6219="&1 Try to resynchronize at any character"
6220="&2 Try to resynchronize at next space"
6221="&3 Try to resynchronize at specified separators"
6222=" &Specify separators..."
6223="&0 No synchronization (compare at fixed positions, e.g. for tables)"
Here is a screenshot to clarify what I mean: Screenshot

Re: [TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-25, 16:37 UTC
by JOUBE
white wrote: 2022-06-25, 11:12 UTCI suggest to change the following strings:
As you write it, it is a suggestion. So please - moderators - move it to "TC suggestions (English)"

Second: in your suggested texts the part (this is the main part) "Find inserted text..." is missing.

So it is not a bug and also not a usefull suggestion.

JO"ah, you're a moderator, "white"? So please move it to "TC suggestions (English)" yourselfs"UBE

Re: [TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-25, 19:18 UTC
by white
JOUBE wrote: 2022-06-25, 16:37 UTC
white wrote: 2022-06-25, 11:12 UTCI suggest to change the following strings:
As you write it, it is a suggestion. So please - moderators - move it to "TC suggestions (English)"
Just because I've used the word "suggestion" to suggest a possible solution doesn't mean the entire report is a suggestion.
JOUBE wrote: 2022-06-25, 16:37 UTC Second: in your suggested texts the part (this is the main part) "Find inserted text..." is missing.

So it is not a bug and also not a usefull suggestion.
If you think that is what it does then I understand why you would think that.

Re: [TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-26, 07:25 UTC
by ghisler(Author)
I thought about talking about resynchronization, but no one outside of a small group of developers will understand what that means. That's why I write about finding inserted text, because that's essentially the purpose of this function.

Re: [TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-26, 12:29 UTC
by Dalai
2ghisler(Author)
The term "resynchronization" (or rather "resync") is already used in the Compare by Content context menu, isn't it?

Re: [TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-26, 13:47 UTC
by white
Dalai wrote: 2022-06-26, 12:29 UTC 2ghisler(Author)
The term "resynchronization" (or rather "resync") is already used in the Compare by Content context menu, isn't it?
The button is called "Sync" too.
ghisler(Author) wrote: 2022-06-26, 07:25 UTC I thought about talking about resynchronization, but no one outside of a small group of developers will understand what that means.
That's still the case. Perhaps even more so.
ghisler(Author) wrote: 2022-06-26, 07:25 UTC That's why I write about finding inserted text, because that's essentially the purpose of this function.
The meaning of "Find inserted text" is very specific here. It's a way of describing synchronization in a way that can only be understood if you understand synchronization.

It finds inserted text as well as modified and deleted text. The option "Find inserted text only at spaces" finds inserted text and modified text not only at spaces, but also in the middle of words.

Please explain to me what you think the user's thought process will be when he reads the options and doesn't know what synchronization is.

How about describing it this way:
6219="&1 Try to resynchronize at any character (finds multiple differences within a word)"
6220="&2 Try to resynchronize at next space (finds 1 difference within a word)"
6221="&3 Try to resynchronize at specified separators"
6222=" &Specify separators..."
6223="&0 No synchronization (compare at fixed positions, e.g. for tables)"

Re: [TC10.50rc3] Compare by Content - Bad names for Sync button options

Posted: 2022-06-27, 09:20 UTC
by ghisler(Author)

Moderator message

Moved to suggestions