Feature #16979

Clarify how to enable a new language on our translation platform

Added by intrigeri about 6 years ago. Updated about 6 years ago.

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 about 6 years ago

  • 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 about 6 years ago

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

@hefee, yes, totally! Thank you :)

#3 Updated by intrigeri about 6 years ago

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

Applied in changeset commit:tails|ff31ffcf42f33a77b67f89c7e9050fd36bd6b1cb.