[wp-trac] [WordPress Trac] #62482: Improve text strings in Twenty Twenty-Five

[WordPress Trac]

#62482: Improve text strings in Twenty Twenty-Five
---------------------------+--------------------
 Reporter:  poena          |      Owner:  (none)
     Type:  enhancement    |     Status:  new
 Priority:  normal         |  Milestone:  6.8
Component:  Bundled Theme  |    Version:  6.7
 Severity:  normal         |   Keywords:
  Focuses:                 |
---------------------------+--------------------
 This ticket replaces
 [https://github.com/WordPress/twentytwentyfive/issues/671 GitHub issue
 671] that was not solved in time before the release of the theme.

 Translators have provided feedback that there are duplicate strings
 because
 the theme adds translators contexts inconsistently.

 Examples:
 "Learn more" without context
 "Learn more" with the context "Sample hero button"
 "Learn more" with the context "Button text of intro section."

 "Search" with the context "Button text. Verb"
 "Search" with the context "Button text. Verb."

 Which means that the text "Learn more" is added 3 times and "Search" two
 times.

 ----

 In addition, after looking at some of the translations that have been
 added, it is my opinion that some of the pattern names and template part
 names could be improved to make them easier to translate.

 For example, this pattern name clearly explains that it is a page
 template:
 "Page template for the right-aligned blog" and this name explains that it
 is the search results:
 "News blog search results"-
 While this name "Right-aligned blog, search" may sound like it is
 referring to the word search as a verb.


 "Vertical Header" has translators believing that "header" is referring to
 a heading/headline/title, and not an alternative site header template
 part.


 ----

 There was also feedback shared on the WordPress Slack, saying that the
 theme is not following the
 [https://make.wordpress.org/docs/style-guide/ Style guide] for writing
 documentation.

 The style guide for quotation marks is to use straight quotes
 https://make.wordpress.org/docs/style-guide/punctuation/quotation-marks/


 Example of where curly quotes are used:

 twentytwentyfive\patterns\banner-poster.php
 {{{
 <?php
 echo wp_kses_post(
 /* translators: This string contains the word "Stories" in four different
 languages with the first item in the locale's language. */
 _x( '“Stories, <span lang="es">historias</span>, <span
 lang="uk">iсторії</span>, <span lang="el">iστορίες</span>”', 'Placeholder
 heading in four languages.', 'twentytwentyfive' )
 );
 ?>
 }}}

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/62482>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform