Guest User

Untitled

a guest
May 9th, 2020
120
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 6.87 KB | None | 0 0
  1. - Capitalization: Use sentence style capitalization by default.
  2. Q: Is this the default already?
  3. A: Default is Title Capitalization on most buttons and UI with some instances in Sentence capitalization (such as items in dropdown menus). I inquired a bunch of people in IRC and most seemed to prefer sentence capitalization.
  4.  
  5. Examples:
  6. Orig:
  7. STR_INTRO_NEW_GAME :{BLACK}New Game
  8. STR_INTRO_LOAD_GAME :{BLACK}Load Game
  9. STR_INTRO_PLAY_SCENARIO :{BLACK}Play Scenario
  10. change:
  11. STR_INTRO_NEW_GAME :{BLACK}New game
  12. STR_INTRO_LOAD_GAME :{BLACK}Load game
  13. STR_INTRO_PLAY_SCENARIO :{BLACK}Play scenario
  14.  
  15. - Capitalization: Use title capitalization on vehicle names, resource names, currencies, locations, buildings, given names & ranks, applications, and keyboard shortcuts.
  16. Q: Is this the default already?
  17. A: IIRC all except for resources which are currently sentence capitalized.
  18.  
  19. Examples:
  20. Orig:
  21. STR_QUANTITY_GRAIN :{WEIGHT_LONG} of grain
  22. STR_QUANTITY_WOOD :{WEIGHT_LONG} of wood
  23. STR_QUANTITY_IRON_ORE :{WEIGHT_LONG} of iron ore
  24. STR_QUANTITY_STEEL :{WEIGHT_LONG} of steel
  25. change:
  26. STR_QUANTITY_GRAIN :{WEIGHT_LONG} of Grain
  27. STR_QUANTITY_WOOD :{WEIGHT_LONG} of Wood
  28. STR_QUANTITY_IRON_ORE :{WEIGHT_LONG} of Iron Ore
  29. STR_QUANTITY_STEEL :{WEIGHT_LONG} of Steel
  30.  
  31. - Tooltips: always leave a paragraph break between a tooltip title and description, and put a colon at the end of the title. If a tooltip only has a title, put no punctuation at the end.
  32. Q: Is this the default already?
  33. A: No. It's present in some strings, such as the tooltips for the signals menu. The reason why I propose this is made a default is because it makes tooltips much easier to read. The break is added by {}.
  34.  
  35. Examples:
  36. Orig:
  37. STR_BUILD_SIGNAL_SEMAPHORE_PBS_TOOLTIP :{BLACK}Path Signal (semaphore){}A path signal allows more than one train to enter a signal block at the same time, if the train can reserve a path to a safe stopping point. Standard path signals can be passed from the back side
  38. change:
  39. STR_BUILD_SIGNAL_SEMAPHORE_PBS_TOOLTIP :{BLACK}Path signal (semaphore):{}Allows more than one train to enter a signal block at the same time, if the train can reserve a path to a safe stopping point. Standard path signals can be passed from the back side
  40.  
  41. == Summary ==
  42. Tooltips: tile/no title
  43. Q: Can this be reviewed from the text files alone or does this need the game client? Is this a lot of churn or are the strings mostly consistent?
  44. A: Has to be reviewed in-game. Title conditions mostly hinge on whether a button is graphic or text-based. Most of these strings aren't particularly hard to find with the game open however, and reviewing is faster than it seems.
  45.  
  46. Examples:
  47. Orig:
  48. STR_RAIL_TOOLBAR_TOOLTIP_BUILD_RAILROAD_STATION :{BLACK}Build railway station. Ctrl enables joining stations. Shift toggles building/showing cost estimate
  49. change:
  50. STR_RAIL_TOOLBAR_TOOLTIP_BUILD_RAILROAD_STATION :{BLACK}Build railway station:{}For loading and unloading cargo or passengers. Ctrl+Click enables merging stations. Shift+Click shows estimated cost without purchase
  51.  
  52. Q: How could translators follow this rule?
  53. A: We are deciding a priori which tooltips have or don't have a title based on the button. Translators simply have to obey tag placement (the {} tags) in the english text. Nothing else to it.
  54.  
  55. == Language style ==
  56. - Jargon and slang will not be used at all.
  57. Q: Are we using this anywhere? Can you provide good/bad examples in the manual of style itself?
  58. A: This is mainly future proofing, but take the previous discussing of bridgehead vs anchorage, the latter being an obscure technical term. Technically bridgehead is preferable because its easier to understand.
  59.  
  60. == Bias-free communication ==
  61. Q: I agree with this section, but especially the "Use gender-neutral alternatives" section might be some churn and could be reviewed separately. I think that wording to make existing strings adhere to this might turn up some discussion around the right new text. As such this should not be forced through in a very large commit with many other smaller / more obvious changes.
  62. A: AFAIK there's barely any of it. I only found "Chairman", in the ranks, and nothing referring to disabilities. No he or she pronouns either, so again, this is mainly future proofing.
  63.  
  64. Examples:
  65. Orig:
  66. STR_COMPANY_LEAGUE_PERFORMANCE_TITLE_CHAIRMAN :Chairman
  67. change:
  68. STR_COMPANY_LEAGUE_PERFORMANCE_TITLE_CHAIRMAN :Chair
  69.  
  70. == Descriptive texts and UI labels ==
  71. Q: This is not useful when you're done, but at this point in time a few examples of tooltips/labels you want to change would be helpful in assessing the before/after state of these rules.
  72. A: This section is more of a categorization to setup up further rules and to tell what is what.
  73.  
  74. == Acronyms ==
  75. Q: Looks fine. Hope the changes to follow this should be minor.
  76. A: I don't think tere's any at the moment.
  77.  
  78. == Capitalization ==
  79. Q: Looks fine. Might be large churn, but easy changes.
  80. A: This is probably the largest amount of churn, but it's pretty much just following the guide IIRC.
  81.  
  82. Examples:
  83. Orig:
  84. STR_FINANCES_SECTION_CONSTRUCTION :{GOLD}Construction
  85. STR_FINANCES_SECTION_NEW_VEHICLES :{GOLD}New Vehicles
  86. STR_FINANCES_SECTION_TRAIN_RUNNING_COSTS :{GOLD}Train Running Costs
  87. STR_FINANCES_SECTION_ROAD_VEHICLE_RUNNING_COSTS :{GOLD}Road Vehicle Running Costs
  88. STR_FINANCES_SECTION_AIRCRAFT_RUNNING_COSTS :{GOLD}Aircraft Running Costs
  89. change:
  90. STR_FINANCES_SECTION_CONSTRUCTION :{GOLD}Construction
  91. STR_FINANCES_SECTION_NEW_VEHICLES :{GOLD}New vehicles
  92. STR_FINANCES_SECTION_TRAIN_RUNNING_COSTS :{GOLD}Train running costs
  93. STR_FINANCES_SECTION_ROAD_VEHICLE_RUNNING_COSTS :{GOLD}Road vehicle running costs
  94. STR_FINANCES_SECTION_AIRCRAFT_RUNNING_COSTS :{GOLD}Aircraft running costs
  95.  
  96. == Formatting ==
  97. Q: Can the "General descriptive text formatting" section be merged into "Descriptive texts and UI labels"/"Descriptive texts" (or the other way around)?
  98. A: Again the previous section is more of an introduction telling what is what. I don't think merging would make much sense.
Add Comment
Please, Sign In to add comment