You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by st...@apache.org on 2015/03/08 03:46:54 UTC
[1/4] cordova-coho git commit: Split Translating Apache Cordova into
bullets
Repository: cordova-coho
Updated Branches:
refs/heads/master cbf435991 -> 4b4edc3d7
Split Translating Apache Cordova into bullets
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/2845fb9c
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/2845fb9c
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/2845fb9c
Branch: refs/heads/master
Commit: 2845fb9cc6fe5f23611804e4fc5cb9392af5fdde
Parents: cbf4359
Author: Josh Soref <js...@blackberry.com>
Authored: Tue Mar 3 18:38:24 2015 -0500
Committer: Josh Soref <js...@blackberry.com>
Committed: Tue Mar 3 19:08:24 2015 -0500
----------------------------------------------------------------------
docs/doc-translation-process.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/2845fb9c/docs/doc-translation-process.md
----------------------------------------------------------------------
diff --git a/docs/doc-translation-process.md b/docs/doc-translation-process.md
index 0dcbf31..4011701 100644
--- a/docs/doc-translation-process.md
+++ b/docs/doc-translation-process.md
@@ -21,7 +21,9 @@
# Translating Apache Cordova
-Apache Cordova's documentation is written in English but translations are available in a number of different languages. These languages are chosen based on volunteers who are willing to help translate from English to their native tongue. We use Crowdin, a translation and localization management platform to collaborate amongst translators and our core team.
+- Apache Cordova's documentation is written in English but translations are available in a number of different languages.
+- These languages are chosen based on volunteers who are willing to help translate from English to their native tongue.
+- We use Crowdin, a translation and localization management platform to collaborate amongst translators and our core team.
# The Process of Translating
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
[4/4] cordova-coho git commit: updated platforms release process
Posted by st...@apache.org.
updated platforms release process
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/4b4edc3d
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/4b4edc3d
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/4b4edc3d
Branch: refs/heads/master
Commit: 4b4edc3d7b2523c373e4485d143cae5e1cf9bf0e
Parents: 3c89368 c4292c6
Author: Steve Gill <st...@gmail.com>
Authored: Sat Mar 7 18:46:43 2015 -0800
Committer: Steve Gill <st...@gmail.com>
Committed: Sat Mar 7 18:46:43 2015 -0800
----------------------------------------------------------------------
docs/platforms-release-process.md | 5 +----
1 file changed, 1 insertion(+), 4 deletions(-)
----------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
[2/4] cordova-coho git commit: Applying Markdown to
doc-translation-process.md
Posted by st...@apache.org.
Applying Markdown to doc-translation-process.md
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/3c893681
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/3c893681
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/3c893681
Branch: refs/heads/master
Commit: 3c893681496de5fe4a095af0108252117d190d96
Parents: 2845fb9
Author: Josh Soref <js...@blackberry.com>
Authored: Tue Mar 3 19:08:12 2015 -0500
Committer: Josh Soref <js...@blackberry.com>
Committed: Tue Mar 3 19:08:26 2015 -0500
----------------------------------------------------------------------
docs/doc-translation-process.md | 134 +++++++++++++++++++++++++----------
1 file changed, 95 insertions(+), 39 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/3c893681/docs/doc-translation-process.md
----------------------------------------------------------------------
diff --git a/docs/doc-translation-process.md b/docs/doc-translation-process.md
index 4011701..6d03ceb 100644
--- a/docs/doc-translation-process.md
+++ b/docs/doc-translation-process.md
@@ -21,39 +21,46 @@
# Translating Apache Cordova
-- Apache Cordova's documentation is written in English but translations are available in a number of different languages.
-- These languages are chosen based on volunteers who are willing to help translate from English to their native tongue.
-- We use Crowdin, a translation and localization management platform to collaborate amongst translators and our core team.
+- **Apache Cordova**'s documentation is written in *English* but translations are available in a number of different languages.
+- These languages are chosen based on volunteers who are willing to help translate from *English* to their *native tongue*.
+- We use **Crowdin**, a translation and localization management platform to collaborate amongst translators and our core team.
# The Process of Translating
-If you know another language and are willing to help translate Apache Cordova, here are the steps to get started:
+If you know another language and are willing to help translate **Apache Cordova**, here are the steps to get started:
-- Create a free account with Crowdin.net http://crowdin.net
-- Search for and find the Cordova project http://crowdin.net/project/cordova/
+- Create a free account with [Crowdin.net]
+- Search for and find the [Crowdin Cordova project]
- Scroll down to find the languages that are currently being translated.
-- Choose a language and click on the language to start contributing. e.g. Spanish http://crowdin.net/project/cordova/es-ES
-- Next to each of the markdown files you will see a button labelled "Translate". Clicking that button will open a translate page where the English version of the file is on the left.
-- Click on a phrase in the left-hand panel. Then type a translation in the textarea to the right. Click the "Commit Translation" button.
-- If a translation is already provided for a phrase you can vote it up or down. If you vote it down be sure to also include what you believe to be the correct translation.
+- Choose a language and click on the language to start contributing.
+ - e.g. [Spanish Cordova project]
+- Next to each of the markdown files you will see a button labelled `Translate`.
+ - Clicking that button will open a translate page where the *English* version of the file is on the left.
+ - Click on a phrase in the left-hand panel.
+ - Then type a translation in the textarea to the right.
+ - Click the `Commit Translation` button.
+ - If a translation is already provided for a phrase you can vote it **up** or **down**.
+ - If you vote it **down**, be sure to also include what you believe to be the correct translation.
## Crowdin Administrative Scripts
There are two scripts and one jar file that need to be in place in your environment in order to automate the crowdin translation process.
-- crowdin-cli.jar
-- crowdin.yaml
-- github-crowdin.sh
+- `crowdin-cli.jar`
+- `crowdin.yaml`
+- `github-crowdin.sh`
-Information on the crowdin command line interface and tooling can be found here: http://crowdin.net/page/cli-tool. It includes a link to download the jar file for Windows, Mac, and Linux.
+Information on the crowdin command line interface and tooling can be found here: [Crowdin cli].
+ It includes a link to download the jar file for **Windows**, **Mac OS X**, and **Linux**.
### Demo video
-Lisa DeLuca has created a demo video showing the process of translating as an adminstrator that can be viewed on youtube here: http://www.youtube.com/watch?v=LSnk3lAd7bo
+**Lisa DeLuca** has created a demo video showing the process of translating as an adminstrator that can be viewed on youtube here: [Crowdin YouTube demo]
### crowdin.yaml
-By default, the crowdin-cli will look for a configuration file called crowdin.yaml. For cordova, our crowdin.yaml file looks like this:
+By default, the `crowdin-cli` will look for a configuration file called `crowdin.yaml`.
+For **Cordova**, our `crowdin.yaml` file looks like this:
project_identifier: cordova
@@ -69,17 +76,22 @@ By default, the crowdin-cli will look for a configuration file called crowdin.ya
-
source: "/**/doc/*.md"
translation: "/**/doc/%two_letters_code%/%original_file_name%"
- ignore:
+ ignore:
- /.git
-It is recommended that Crowdin be pulled from a fork of the cordova-docs github project rather than directly from the main project. This script grabs the markdown .md files from the docs/en/edge directory and pushes them into the Crowdin service for each of the lanuages that are available within crowdin. For information on the api_key value, please email the crowdin project administrator: ldeluca@apache.org
+It is recommended that **Crowdin** be pulled from a *fork* of the `cordova-docs` github project rather than directly from the main project.
+
+This script grabs the **markdown** `.md` files from the `docs/en/edge` directory and pushes them into the Crowdin service for each of the lanuages that are available within crowdin.
+
+For information on the `api_key` value,
+please email the [crowdin project administrator].
## github-crowdin.sh
-The github-crowdin.sh script is the script that is run to initiate the translation flow.
-It is a custom script that first pushes any of the changed markdown files into crowdin.
-It then searches through all of the languages from crowdin and downloads only those languages that are 100%
-translated. Finally, it pushes the translated language files back into github.
+The `github-crowdin.sh` script is the script that is run to initiate the translation flow.
+It is a custom script that first pushes any of the changed **markdown** files into crowdin.
+It then searches through all of the languages from crowdin and downloads only those languages that are 100% translated.
+Finally, it pushes the translated language files back into github.
#!/bin/bash
DOMAIN_NAME='http://api.crowdin.net'
@@ -400,36 +412,58 @@ The script will print out the name of each file being downloaded
### Crowdin Error Debugging
-After running the github-crowdin.sh script, some common messages might include:
+After running the `github-crowdin.sh` script, some common messages might include:
- Warning: Downloaded translations does not match current project configuration. Some of the resulted files will be omitted.
- - `docs/zh/README.md'
- Crowdin has internal caching mechanisms that prevents us from overload. Please try to download translations later.
+```
+ Warning: Downloaded translations does not match current project configuration.
+ Some of the resulted files will be omitted.
-This message can be ignored. It does not affect the downloaded files.
-It simply means that that markdown file no longer exists. Please open a JIRA issue and assign to Lisa DeLuca to let her know if you see this error. Then the file can be removed from the crowdin file manager.
+ - docs/zh/README.md
+```
+```
+Crowdin has internal caching mechanisms that prevents us from overload.
+Please try to download translations later.
+```
+This message can be ignored.
+It does not affect the downloaded files.
+It simply means that that **markdown** file no longer exists.
+Please [open a JIRA] issue and assign to `Lisa DeLuca` to let her know if you see this error.
+Then the file can be removed from the crowdin file manager.
+
+```
A communication error occured: ""
</FONT>
</TD></TR>
<TR><TD>
<FONT face="Helvetica">
The Web Server may be down, too busy, or experiencing other problems preventing it from responding to requests. You may wish to try again at a later time.
-It is often the case where you will see a message that crowdin is down, like the one shown above. In which case you'll need to wait until Crowdin is back up or email their support team at: mailto:support@crowdin.net . Alternatively, it could just mean that a manual build needs to be kicked off within the Crowdin tool. Under Settings > Translation > click the button to build a fresh package.
+```
+
+It is often the case where you will see a message that crowdin is down, like the one shown above.
+In which case you'll need to wait until Crowdin is back up or email the [crowdin support team].
+Alternatively, it could just mean that a manual build needs to be kicked off within the Crowdin tool.
+Under `Settings > Translation >` click the button to `build a fresh package`.
### Testing Translations
-Before performing a pull request it is recommended that each language be built locally and tested for accuracy. To do this, run the following script
+Before performing a pull request it is recommended that each language be built locally and tested for accuracy.
+To do this, run the following script:
+
+ ~/git/cordova-docs$ bin/generate ru edge
-~/git/cordova-docs$ bin/generate ru edge
-ru in this case would run the Russian language. See the cordova-docs documentation for more information on building the documentation.
+`ru` in this case would run the Russian language.
+See the `cordova-docs` documentation for more information on building the documentation.
### Viewing Translations
-After the translations have been pulled into the main Apache Cordova branch they can be viewed here
-http://cordova.apache.org/docs/en/edge/index.html . Go to the upper-right-hand corner and select the drop down.
-Scrolling to the bottom you will see the new languages that have been translated. The translations for the individual plugins
+After the translations have been pulled into the main Apache Cordova branch they can be viewed here: [Cordova docs edge].
+
+* Go to the upper-right-hand corner and select the drop down.
+* Scrolling to the bottom you will see the new languages that have been translated.
+
+The translations for the individual plugins
are only viewable from GitHub under the docs directory for each plugin.
## Manual Steps
@@ -437,15 +471,37 @@ are only viewable from GitHub under the docs directory for each plugin.
Even though the majority of the Crowdin Apache Cordova translations are automated there are still a few things that need to be manually monitored by our administrators.
- Headers - Consistency in translation between headers and other linked content
-- Code snippets - Marking code snippets as "Do Not Translate"
+- Code snippets - Marking code snippets as `Do not translate`
### Headers
-When a header is not consistently translated between pages then a link will appear broken and it will be impossible for users to view the content. If, when verifying translated documentation, a link doesn't appear highlighted and clickable, go through the markdown files and make sure the translations are consistent for the headers. It is recommended that the documentation is built and verified after each crowdin script is ran before contributing the content back into the main stream.
+When a header is not consistently translated between pages then a link will appear broken and it will be impossible for users to view the content.
+
+If, when verifying translated documentation,
+a link doesn't appear highlighted and clickable,
+go through the **markdown** files and make sure the translations are consistent for the headers.
+
+It is recommended that the documentation is built and verified after each crowdin script is run before contributing the content back into the main stream.
### Code Snippets
-Code snippets should be marked as "Do not translate" which will not allow individual translators to come in and translate the code snippets. However, when new code snippets or commands are entered in the code the administrator will need to come in and mark that new section which could lead to it going unmarked and manual or automated translations of the code might occur. To remedy this, an administrator can go into the code snippet and delete the suggested translation and mark the phrase as "Do not translate".
+Code snippets should be marked as `Do not translate` which will not allow individual translators to come in and translate the code snippets.
+
+However, when *new code snippets* or *commands* are entered in the code, the administrator will need to come in and *mark that new section* which could lead to it going *unmarked* and *manual* or *automated translations* of the code might occur.
+
+To remedy this, an administrator can go into the code snippet and *delete the suggested translation* and *mark the phrase* as `Do not translate`.
-Another example is the use of method names, constants, etc. scattered throughout the documentation. It is not currently possible for an administrator to mark each of these elements as "Do not translate", so our proofreaders will need to go through and verify they are not translated by translators or by the automated translation services.
+Another example is the use of *method names*, *constants*, etc., scattered throughout the documentation.
+It is not currently possible for an administrator to mark each of these elements as `Do not translate`,
+so our proofreaders will need to go through and verify they are not translated by translators or by the automated translation services.
+[Crowdin.net]: http://crowdin.net "Crowdin.net"
+[Crowdin Cordova project]: http://crowdin.net/project/cordova/
+[Spanish Cordova project]: http://crowdin.net/project/cordova/es-ES
+[Crowdin cli]: http://crowdin.net/page/cli-tool
+[Crowdin YouTube demo]: http://www.youtube.com/watch?v=LSnk3lAd7bo
+[Cordova docs edge]: http://cordova.apache.org/docs/en/edge/index.html
+[JIRA]: https://issues.apache.org/jira/browse/CB
+[open a JIRA]: https://issues.apache.org/jira/secure/CreateIssue.jspa
+[crowdin support team]: mailto:support@crowdin.net
+[crowdin project administrator]: mailto:ldeluca@apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
[3/4] cordova-coho git commit: Remove updating www template step
Posted by st...@apache.org.
Remove updating www template step
This is getting moved to cordova-app-hello-world release steps
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/c4292c6f
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/c4292c6f
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/c4292c6f
Branch: refs/heads/master
Commit: c4292c6f105f0868777cd7b7648435c7f35d8a8c
Parents: cbf4359
Author: Steve Gill <st...@adobe.com>
Authored: Sat Mar 7 18:43:54 2015 -0800
Committer: Steve Gill <st...@adobe.com>
Committed: Sat Mar 7 18:43:54 2015 -0800
----------------------------------------------------------------------
docs/platforms-release-process.md | 5 +----
1 file changed, 1 insertion(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/c4292c6f/docs/platforms-release-process.md
----------------------------------------------------------------------
diff --git a/docs/platforms-release-process.md b/docs/platforms-release-process.md
index 6914b96..681eacc 100644
--- a/docs/platforms-release-process.md
+++ b/docs/platforms-release-process.md
@@ -60,11 +60,8 @@ E.g.:
1. Run [Apache RAT](http://creadur.apache.org/rat/) to ensure copyright headers are present
* `coho audit-license-headers -r android | less`
- 1. Run check-license to ensure all dependencies and subdependencies have valid licenses
+ 2. Run check-license to ensure all dependencies and subdependencies have valid licenses
* `coho check-license -r platform`
- 2. Update the copy of app-hello-world (if there were any changes to it)
- * This usually lives within bin/templates somewhere
- * TODO: More details needed here
3. For iOS only:
* Update [CordovaLib/Classes/CDVAvailability.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVAvailability.h)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org