Feature #16979

Clarify how to enable a new language on our translation platform

Added by intrigeri 2019-08-15 08:32:34 . Updated 2019-08-21 12:19:11 .

Status:
Resolved
Priority:
Normal
Assignee:
intrigeri
Category:
Infrastructure
Target version:
Start date:
Due date:
% Done:

100%

Feature Branch:
Type of work:
Contributors documentation
Blueprint:

Starter:
Affected tool:
Translation Platform
Deliverable for:
309

Description

  • “You need to run this script with argument `—modify`”: I’m confused. Previously I’m instructed to run that script without any argument. If I have to pass --modify, let’s just add it to the copy’n’pasteable command line and drop this sentence?
  • “You need to […] to actually create the missing po files and commit those files”: ambiguous English grammar, this could mean either that the script with --modify will add+commit the files, or that I have to do it myself once the script has run.

I’m happy to rephrase the doc (or let u do it) once you’ve clarified what you meant :)


Subtasks


History

#1 Updated by hefee 2019-08-15 19:29:09

  • Assignee changed from hefee to intrigeri

intrigeri wrote:
> * “You need to run this script with argument `—modify`”: I’m confused. Previously I’m instructed to run that script without any argument. If I have to pass --modify, let’s just add it to the copy’n’pasteable command line and drop this sentence?

My thought is, that people if they just copy&paste can’t break anything and need actully to read. Otherwise they may change things that you don’t want to be changed. In my ideal world people first run the command without --modify check the output and rerun it with --modify.
But i don’t want to break the documentation style, if the rest is more just copy&pasteable, than I won’t stop you, if you add the --modify into the command right away.

> * “You need to […] to actually create the missing po files and commit those files”: ambiguous English grammar, this could mean either that the script with --modify will add+commit the files, or that I have to do it myself once the script has run.

The sentence is about what the script will do, if you run it with the --modify argument. You neither need to create the po files by hand nor commit them by hand.

> I’m happy to rephrase the doc (or let u do it) once you’ve clarified what you meant :)

Hope this is more clear now, what I wanted to express.

#2 Updated by intrigeri 2019-08-15 20:17:02

> Hope this is more clear now, what I wanted to express.

@hefee, yes, totally! Thank you :)

#3 Updated by intrigeri 2019-08-21 12:19:12

  • Status changed from Confirmed to Resolved
  • % Done changed from 0 to 100

Applied in changeset commit:tails|ff31ffcf42f33a77b67f89c7e9050fd36bd6b1cb.