Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add and improve translator comments and tooltips for peers tab address fields #554

Conversation

jonatack
Copy link
Member

@jonatack jonatack commented Feb 20, 2022

Per translator feedback in this thread: #526 (comment)

"The lack of string context in Transifex is a real problem for this project, as proper context (dev notes and/or screenshots) are essential to achieve quality translations."

This pull adds developer notes for transifex translators via extracomment tags, and it improves the existing ones and their tooltips with more context, clarity and completeness for the following peer tab fields as a follow-up to #526:

  • address relay
  • addresses processed
  • addressed rate-limited

It looks like only six lines of diff, but they are loooong lines.

If this is the right direction, the same can be done for other fields in follow-ups.

Copy link
Contributor

@promag promag left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Concept ACK, seems to be in line with what was suggested/requested.

src/qt/forms/debugwindow.ui Outdated Show resolved Hide resolved
@jonatack jonatack force-pushed the improve-peers-tab-address-fields-extracomments-and-tooltips branch from e25e88a to bcd72ef Compare February 22, 2022 08:17
@jonatack
Copy link
Member Author

Updated per @promag feedback (thanks!)

Copy link
Member

@jarolrod jarolrod left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK bcd72ef

I've been collecting thoughts on how to formulate translator comments here and the translator comments introduced here tick the boxes.

in reference to the translator comment documentation I've prepared: in 1df9daa you allude to what the value of the field is, I wonder if I should include that point as required context in the doc.

If you retouch, and definitely not necessary, you could rename the PR to Add and improve peers tab address translator comments and tooltips and similarly update the commits to state they are updating translator comments instead of extracomment.

@jonatack jonatack changed the title Add and improve peers tab address fields dev notes and tooltips Add and improve peers tab address translator comments and tooltips Mar 6, 2022
@jonatack jonatack changed the title Add and improve peers tab address translator comments and tooltips Add and improve translator comments and tooltips for peers tab address fields Mar 6, 2022
@jonatack jonatack force-pushed the improve-peers-tab-address-fields-extracomments-and-tooltips branch from bcd72ef to 4d2b503 Compare March 6, 2022 16:50
@jonatack
Copy link
Member Author

jonatack commented Mar 6, 2022

ACK bcd72ef

in reference to the translator comment documentation I've prepared: in 1df9daa you allude to what the value of the field is, I wonder if I should include that point as required context in the doc.

Describing the value(s) of the field where relevant and helpful seems like a good idea. (Nice doc BTW.)

If you retouch, and definitely not necessary, you could rename the PR to Add and improve peers tab address translator comments and tooltips and similarly update the commits to state they are updating translator comments instead of extracomment.

Done!

Copy link
Member

@jarolrod jarolrod left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

re-ACK 4d2b503

Thanks for picking up the suggestions!

Copy link
Member

@hebasto hebasto left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK 4d2b503, I have reviewed the code and it looks OK, I agree it can be merged.

@hebasto hebasto merged commit ae005a6 into bitcoin-core:master Mar 20, 2022
@jonatack jonatack deleted the improve-peers-tab-address-fields-extracomments-and-tooltips branch March 20, 2022 08:40
sidhujag pushed a commit to syscoin/syscoin that referenced this pull request Mar 22, 2022
…ooltips for peers tab address fields

4d2b503 gui: improve "Addresses Rate-Limited" translator comments and tooltip in peers tab (Jon Atack)
81ef1f7 gui: improve "Addresses Processed" translator comments and tooltip in peers tab (Jon Atack)
77f24aa gui: improve "Address Relay" translator comments and tooltip in peers tab (Jon Atack)

Pull request description:

  Per translator feedback in this thread: bitcoin-core/gui#526 (comment)

  *"The lack of string context in Transifex is a real problem for this project, as proper context (dev notes and/or screenshots) are essential to achieve quality translations."*

  This pull adds developer notes for transifex translators via `extracomment` tags, and it improves the existing ones and their tooltips with more context, clarity and completeness for the following peer tab fields as a follow-up to bitcoin-core/gui#526:

  - address relay
  - addresses processed
  - addressed rate-limited

  It looks like only six lines of diff, but they are loooong lines.

  If this is the right direction, the same can be done for other fields in follow-ups.

ACKs for top commit:
  jarolrod:
    re-ACK [4d2b503](bitcoin-core/gui@4d2b503)
  hebasto:
    ACK 4d2b503, I have reviewed the code and it looks OK, I agree it can be merged.

Tree-SHA512: a185f46a66375a5fd6854640745b7d1d00740cf7be58db03256f44d71acc351e1770de137cb3bc9c1f0ea3cabd7cfa1cb1ccb87ec0df222680924ca3dab6c8bf
@bitcoin-core bitcoin-core locked and limited conversation to collaborators Jun 26, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants