You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/09/18 19:27:49 UTC
[1/7] git commit: CB-7471 added translation information to the coho
docs
Repository: cordova-coho
Updated Branches:
refs/heads/CB-7471 0ea383ab2 -> ef830183f
CB-7471 added translation information to the coho docs
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/86cd0951
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/86cd0951
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/86cd0951
Branch: refs/heads/CB-7471
Commit: 86cd095115bba22ee1be8aa3ec2cc4f4cfe46f32
Parents: 0ea383a
Author: Lisa Seacat DeLuca <ld...@us.ibm.com>
Authored: Mon Sep 15 17:53:05 2014 -0400
Committer: Lisa Seacat DeLuca <ld...@us.ibm.com>
Committed: Mon Sep 15 17:53:05 2014 -0400
----------------------------------------------------------------------
docs/doc-translation-process.md | 443 +++++++++++++++++++++++++++++++++++
docs/index.md | 1 +
2 files changed, 444 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/86cd0951/docs/doc-translation-process.md
----------------------------------------------------------------------
diff --git a/docs/doc-translation-process.md b/docs/doc-translation-process.md
new file mode 100644
index 0000000..c170487
--- /dev/null
+++ b/docs/doc-translation-process.md
@@ -0,0 +1,443 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+
+# 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.
+
+# The Process of Translating
+
+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/
+- 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.
+
+## Crowdin Administrative Scripts
+
+There are two scripts that need to be in place in your environment in order to automate the crowdin translation process.
+
+- crowdin.yaml
+- github-crowdin.sh
+Additionally, the crowdin-cli.jar file needs to be installed on the system.
+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.
+
+## 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:
+
+
+ project_identifier: cordova
+ api_key: ____ourAPIkey________
+ base_path: /Users/ldeluca/git/cordova #working copy path
+
+ files:
+ -
+ source: "/cordova-docs/docs/en/edge/**/*.md"
+ translation: "/cordova-docs/docs/%two_letters_code%/edge/**/%original_file_name%"
+ ignore:
+ - /.git
+ -
+ source: "/**/doc/*.md"
+ translation: "/**/doc/%two_letters_code%/%original_file_name%"
+ 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
+
+## 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.
+
+ #!/bin/bash
+ DOMAIN_NAME='http://api.crowdin.net'
+
+ #---CHANGE THE VARIABLES BELOW---
+ BASE_GIT_REPO_PATH=/Users/ldeluca/git/cordova
+ GIT_REPO_PATH=/Users/ldeluca/git/cordova/cordova-docs
+ CROWDIN_CLI_PATH=/Users/ldeluca/crowdin
+ PROJECT_IDENTIFIER='cordova'
+ PROJECT_KEY='----insertkeyhere------'
+
+ #--- git repos
+ ## declare an array variable
+ declare -a gitrepos=("cordova-docs" "cordova-cli" "cordova-plugin-battery-status" "cordova-plugin-camera" "cordova-plugin-console" "cordova-plugin-contacts" "cordova-plugin-device" "cordova-plugin-device-motion" "cordova-plugin-device-orientation" "cordova-plugin-dialogs" "cordova-plugin-file" "cordova-plugin-file-transfer" "cordova-plugin-geolocation" "cordova-plugin-globalization" "cordova-plugin-inappbrowser" "cordova-plugin-media" "cordova-plugin-media-capture" "cordova-plugin-network-information" "cordova-plugin-splashscreen" "cordova-plugin-statusbar" "cordova-plugin-vibration")
+
+
+ read -p "What is the name of the JIRA issue?" jira
+
+ #---
+ ## now loop through the gitrepos array
+ for i in "${gitrepos[@]}"
+ do
+ echo "**************** $i *************************"
+ cd $BASE_GIT_REPO_PATH/$i
+
+ # make sure the fork has the latest from apache master
+ git checkout master
+ git pull apache master
+ git push origin master
+
+ #create topic branch and checkout (USE -b flag for new branch)
+ git checkout -b $jira$i
+
+ # below pushes changes from local to fork
+ git push origin $jira$i
+ done
+
+ rm
+ cd $CROWDIN_CLI_PATH
+
+ java -jar crowdin-cli.jar upload sources
+
+ curl $DOMAIN_NAME/api/project/$PROJECT_IDENTIFIER/status?key=$PROJECT_KEY > result.xml
+
+ read_dom () {
+ local IFS=\>
+ read -d \< ENTITY CONTENT
+ }
+
+ while read_dom; do
+ if [[ $ENTITY = "code" ]] ; then
+ code=( "${code[@]}" "$CONTENT" )
+ fi
+ if [[ $ENTITY = "translated_progress" ]] ; then
+ progress=( "${progress[@]}" "$CONTENT" )
+ fi
+ done < result.xml
+
+ for (( i = 0; i < ${#progress[@]}; i++ )); do
+ if [ "${progress[$i]}" = "100" ]; then
+ index=( "${index[@]}" "$i" )
+ else
+ echo "------- language not at 100 percent ${code[$i]} ------"
+ fi
+ done
+
+ for element in "${index[@]}"; do
+ java -jar crowdin-cli.jar download -l ${code[$element]}
+ done
+
+ # fix crowdin issues:
+ echo "About to fix crowdin errors with resulting files"cd
+ #find /Users/ldeluca/git/cordova/ -name \*.md -exec sed -i "s/\* \* \*/---/1" {} \;
+ #find /Users/ldeluca/git/cordova/ -name \*.md -exec sed -i "s/## under the License./ under the License.\n---/g" {} \;
+ echo "Done with crowdin fix"
+
+ ## now loop through the gitrepos array
+
+
+
+ for i in "${gitrepos[@]}"
+ do
+ echo "**************** $i *************************"
+ cd $BASE_GIT_REPO_PATH/$i
+ git add .
+ git commit -am "$jira $i documentation translation: $i"
+
+
+ #update the new branch
+ #notneeded git pull --rebase apache master
+ git push origin $jira$i
+
+ #merge topic branch into apache/master
+ git checkout master
+ git pull --rebase apache master
+ git merge $jira$i
+ git rebase apache/master -i
+
+ #push changes of master
+ git push apache master
+
+ #all done, delete the branch
+ git push origin $jira$i
+ git branch -D $jira$i
+ done
+
+
+
+## Script output
+
+The script will print out the name of each file being downloaded
+
+ Download: `/docs/zh/edge/cordova/accelerometer/accelerometer.clearWatch.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/accelerometer.getCurrentAcceleration.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/accelerometer.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/accelerometer.watchAcceleration.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/acceleration/acceleration.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/parameters/accelerometerSuccess.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/parameters/accelerometerOptions.md'
+ Download: `/docs/zh/edge/cordova/accelerometer/parameters/accelerometerError.md'
+ Download: `/docs/zh/edge/cordova/camera/camera.cleanup.md'
+ Download: `/docs/zh/edge/cordova/camera/camera.getPicture.md'
+ Download: `/docs/zh/edge/cordova/camera/camera.md'
+ Download: `/docs/zh/edge/cordova/camera/parameter/CameraPopoverHandle.md'
+ Download: `/docs/zh/edge/cordova/camera/parameter/cameraSuccess.md'
+ Download: `/docs/zh/edge/cordova/camera/parameter/cameraOptions.md'
+ Download: `/docs/zh/edge/cordova/camera/parameter/cameraError.md'
+ Download: `/docs/zh/edge/cordova/camera/parameter/CameraPopoverOptions.md'
+ Download: `/docs/zh/edge/cordova/compass/compass.getCurrentHeading.md'
+ Download: `/docs/zh/edge/cordova/compass/compass.md'
+ Download: `/docs/zh/edge/cordova/compass/compass.watchHeading.md'
+ Download: `/docs/zh/edge/cordova/compass/compass.watchHeadingFilter.md'
+ Download: `/docs/zh/edge/cordova/compass/compass.clearWatch.md'
+ Download: `/docs/zh/edge/cordova/compass/compass.clearWatchFilter.md'
+ Download: `/docs/zh/edge/cordova/compass/compassError/compassError.md'
+ Download: `/docs/zh/edge/cordova/compass/parameters/compassSuccess.md'
+ Download: `/docs/zh/edge/cordova/compass/parameters/compassOptions.md'
+ Download: `/docs/zh/edge/cordova/compass/parameters/compassHeading.md'
+ Download: `/docs/zh/edge/cordova/compass/parameters/compassError.md'
+ Download: `/docs/zh/edge/cordova/connection/connection.md'
+ Download: `/docs/zh/edge/cordova/connection/connection.type.md'
+ Download: `/docs/zh/edge/cordova/contacts/contacts.find.md'
+ Download: `/docs/zh/edge/cordova/contacts/contacts.md'
+ Download: `/docs/zh/edge/cordova/contacts/contacts.create.md'
+ Download: `/docs/zh/edge/cordova/contacts/Contact/contact.md'
+ Download: `/docs/zh/edge/cordova/contacts/ContactAddress/contactaddress.md'
+ Download: `/docs/zh/edge/cordova/contacts/ContactError/contactError.md'
+ Download: `/docs/zh/edge/cordova/contacts/ContactField/contactfield.md'
+ Download: `/docs/zh/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md'
+ Download: `/docs/zh/edge/cordova/contacts/ContactName/contactname.md'
+ Download: `/docs/zh/edge/cordova/contacts/ContactOrganization/contactorganization.md'
+ Download: `/docs/zh/edge/cordova/contacts/parameters/contactSuccess.md'
+ Download: `/docs/zh/edge/cordova/contacts/parameters/contactFindOptions.md'
+ Download: `/docs/zh/edge/cordova/contacts/parameters/contactFields.md'
+ Download: `/docs/zh/edge/cordova/contacts/parameters/contactError.md'
+ Download: `/docs/zh/edge/cordova/device/device.model.md'
+ Download: `/docs/zh/edge/cordova/device/device.name.md'
+ Download: `/docs/zh/edge/cordova/device/device.platform.md'
+ Download: `/docs/zh/edge/cordova/device/device.uuid.md'
+ Download: `/docs/zh/edge/cordova/device/device.version.md'
+ Download: `/docs/zh/edge/cordova/device/device.cordova.md'
+ Download: `/docs/zh/edge/cordova/device/device.md'
+ Download: `/docs/zh/edge/cordova/events/events.md'
+ Download: `/docs/zh/edge/cordova/events/events.menubutton.md'
+ Download: `/docs/zh/edge/cordova/events/events.offline.md'
+ Download: `/docs/zh/edge/cordova/events/events.online.md'
+ Download: `/docs/zh/edge/cordova/events/events.pause.md'
+ Download: `/docs/zh/edge/cordova/events/events.resume.md'
+ Download: `/docs/zh/edge/cordova/events/events.searchbutton.md'
+ Download: `/docs/zh/edge/cordova/events/events.startcallbutton.md'
+ Download: `/docs/zh/edge/cordova/events/events.volumedownbutton.md'
+ Download: `/docs/zh/edge/cordova/events/events.volumeupbutton.md'
+ Download: `/docs/zh/edge/cordova/events/events.backbutton.md'
+ Download: `/docs/zh/edge/cordova/events/events.batterycritical.md'
+ Download: `/docs/zh/edge/cordova/events/events.batterylow.md'
+ Download: `/docs/zh/edge/cordova/events/events.batterystatus.md'
+ Download: `/docs/zh/edge/cordova/events/events.deviceready.md'
+ Download: `/docs/zh/edge/cordova/events/events.endcallbutton.md'
+ Download: `/docs/zh/edge/cordova/file/file.md'
+ Download: `/docs/zh/edge/cordova/file/directoryentry/directoryentry.md'
+ Download: `/docs/zh/edge/cordova/file/directoryreader/directoryreader.md'
+ Download: `/docs/zh/edge/cordova/file/fileentry/fileentry.md'
+ Download: `/docs/zh/edge/cordova/file/fileerror/fileerror.md'
+ Download: `/docs/zh/edge/cordova/file/fileobj/fileobj.md'
+ Download: `/docs/zh/edge/cordova/file/filereader/filereader.md'
+ Download: `/docs/zh/edge/cordova/file/filesystem/filesystem.md'
+ Download: `/docs/zh/edge/cordova/file/filetransfer/filetransfer.md'
+ Download: `/docs/zh/edge/cordova/file/filetransfererror/filetransfererror.md'
+ Download: `/docs/zh/edge/cordova/file/fileuploadoptions/fileuploadoptions.md'
+ Download: `/docs/zh/edge/cordova/file/fileuploadresult/fileuploadresult.md'
+ Download: `/docs/zh/edge/cordova/file/filewriter/filewriter.md'
+ Download: `/docs/zh/edge/cordova/file/flags/flags.md'
+ Download: `/docs/zh/edge/cordova/file/localfilesystem/localfilesystem.md'
+ Download: `/docs/zh/edge/cordova/file/metadata/metadata.md'
+ Download: `/docs/zh/edge/cordova/geolocation/geolocation.getCurrentPosition.md'
+ Download: `/docs/zh/edge/cordova/geolocation/geolocation.md'
+ Download: `/docs/zh/edge/cordova/geolocation/geolocation.watchPosition.md'
+ Download: `/docs/zh/edge/cordova/geolocation/geolocation.clearWatch.md'
+ Download: `/docs/zh/edge/cordova/geolocation/Coordinates/coordinates.md'
+ Download: `/docs/zh/edge/cordova/geolocation/Position/position.md'
+ Download: `/docs/zh/edge/cordova/geolocation/PositionError/positionError.md'
+ Download: `/docs/zh/edge/cordova/geolocation/parameters/geolocationSuccess.md'
+ Download: `/docs/zh/edge/cordova/geolocation/parameters/geolocationError.md'
+ Download: `/docs/zh/edge/cordova/geolocation/parameters/geolocation.options.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getNumberPattern.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getPreferredLanguage.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.isDayLightSavingsTime.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.numberToString.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.stringToDate.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.stringToNumber.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.dateToString.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getCurrencyPattern.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getDateNames.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getDatePattern.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getFirstDayOfWeek.md'
+ Download: `/docs/zh/edge/cordova/globalization/globalization.getLocaleName.md'
+ Download: `/docs/zh/edge/cordova/globalization/GlobalizationError/globalizationerror.md'
+ Download: `/docs/zh/edge/cordova/inappbrowser/inappbrowser.md'
+ Download: `/docs/zh/edge/cordova/inappbrowser/window.open.md'
+ Download: `/docs/zh/edge/cordova/media/media.getCurrentPosition.md'
+ Download: `/docs/zh/edge/cordova/media/media.getDuration.md'
+ Download: `/docs/zh/edge/cordova/media/media.md'
+ Download: `/docs/zh/edge/cordova/media/media.pause.md'
+ Download: `/docs/zh/edge/cordova/media/media.play.md'
+ Download: `/docs/zh/edge/cordova/media/media.release.md'
+ Download: `/docs/zh/edge/cordova/media/media.seekTo.md'
+ Download: `/docs/zh/edge/cordova/media/media.setVolume.md'
+ Download: `/docs/zh/edge/cordova/media/media.startRecord.md'
+ Download: `/docs/zh/edge/cordova/media/media.stop.md'
+ Download: `/docs/zh/edge/cordova/media/media.stopRecord.md'
+ Download: `/docs/zh/edge/cordova/media/MediaError/mediaError.md'
+ Download: `/docs/zh/edge/cordova/media/Parameters/mediaError.md'
+ Download: `/docs/zh/edge/cordova/media/capture/captureAudio.md'
+ Download: `/docs/zh/edge/cordova/media/capture/captureAudioOptions.md'
+ Download: `/docs/zh/edge/cordova/media/capture/captureImageOptions.md'
+ Download: `/docs/zh/edge/cordova/media/capture/captureVideo.md'
+ Download: `/docs/zh/edge/cordova/media/capture/captureImage.md'
+ Download: `/docs/zh/edge/cordova/media/capture/captureVideoOptions.md'
+ Download: `/docs/zh/edge/cordova/media/capture/capture.md'
+ Download: `/docs/zh/edge/cordova/media/capture/MediaFile.getFormatData.md'
+ Download: `/docs/zh/edge/cordova/media/capture/MediaFileData.md'
+ Download: `/docs/zh/edge/cordova/media/capture/MediaFile.md'
+ Download: `/docs/zh/edge/cordova/media/capture/ConfigurationData.md'
+ Download: `/docs/zh/edge/cordova/media/capture/CaptureErrorCB.md'
+ Download: `/docs/zh/edge/cordova/media/capture/CaptureError.md'
+ Download: `/docs/zh/edge/cordova/media/capture/CaptureCB.md'
+ Download: `/docs/zh/edge/cordova/notification/notification.confirm.md'
+ Download: `/docs/zh/edge/cordova/notification/notification.md'
+ Download: `/docs/zh/edge/cordova/notification/notification.prompt.md'
+ Download: `/docs/zh/edge/cordova/notification/notification.vibrate.md'
+ Download: `/docs/zh/edge/cordova/notification/notification.alert.md'
+ Download: `/docs/zh/edge/cordova/notification/notification.beep.md'
+ Download: `/docs/zh/edge/cordova/splashscreen/splashscreen.md'
+ Download: `/docs/zh/edge/cordova/splashscreen/splashscreen.show.md'
+ Download: `/docs/zh/edge/cordova/splashscreen/splashscreen.hide.md'
+ Download: `/docs/zh/edge/cordova/storage/storage.md'
+ Download: `/docs/zh/edge/cordova/storage/storage.opendatabase.md'
+ Download: `/docs/zh/edge/cordova/storage/database/database.md'
+ Download: `/docs/zh/edge/cordova/storage/localstorage/localstorage.md'
+ Download: `/docs/zh/edge/cordova/storage/parameters/version.md'
+ Download: `/docs/zh/edge/cordova/storage/parameters/display_name.md'
+ Download: `/docs/zh/edge/cordova/storage/parameters/size.md'
+ Download: `/docs/zh/edge/cordova/storage/parameters/name.md'
+ Download: `/docs/zh/edge/cordova/storage/sqlerror/sqlerror.md'
+ Download: `/docs/zh/edge/cordova/storage/sqlresultset/sqlresultset.md'
+ Download: `/docs/zh/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md'
+ Download: `/docs/zh/edge/cordova/storage/sqltransaction/sqltransaction.md'
+ Download: `/docs/zh/edge/guide/cli/index.md'
+ Download: `/docs/zh/edge/guide/overview/index.md'
+ Download: `/docs/zh/edge/guide/platforms/index.md'
+ Download: `/docs/zh/edge/guide/platforms/android/plugin.md'
+ Download: `/docs/zh/edge/guide/platforms/android/tools.md'
+ Download: `/docs/zh/edge/guide/platforms/android/upgrading.md'
+ Download: `/docs/zh/edge/guide/platforms/android/webview.md'
+ Download: `/docs/zh/edge/guide/platforms/android/config.md'
+ Download: `/docs/zh/edge/guide/platforms/android/index.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry/plugin.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry/tools.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry/upgrading.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry/config.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry/index.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry10/plugin.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry10/tools.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry10/index.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry10/upgrading.md'
+ Download: `/docs/zh/edge/guide/platforms/blackberry10/config.md'
+ Download: `/docs/zh/edge/guide/platforms/firefoxos/config.md'
+ Download: `/docs/zh/edge/guide/platforms/ios/tools.md'
+ Download: `/docs/zh/edge/guide/platforms/ios/upgrading.md'
+ Download: `/docs/zh/edge/guide/platforms/ios/webview.md'
+ Download: `/docs/zh/edge/guide/platforms/ios/config.md'
+ Download: `/docs/zh/edge/guide/platforms/ios/index.md'
+ Download: `/docs/zh/edge/guide/platforms/ios/plugin.md'
+ Download: `/docs/zh/edge/guide/platforms/tizen/index.md'
+ Download: `/docs/zh/edge/guide/platforms/win8/tools.md'
+ Download: `/docs/zh/edge/guide/platforms/win8/upgrading.md'
+ Download: `/docs/zh/edge/guide/platforms/win8/index.md'
+ Download: `/docs/zh/edge/guide/platforms/wp7/index.md'
+ Download: `/docs/zh/edge/guide/platforms/wp8/tools.md'
+ Download: `/docs/zh/edge/guide/platforms/wp8/upgrading.md'
+ Download: `/docs/zh/edge/guide/platforms/wp8/index.md'
+ Download: `/docs/zh/edge/guide/platforms/wp8/plugin.md'
+ Download: `/docs/zh/edge/guide/appdev/privacy/index.md'
+ Download: `/docs/zh/edge/guide/appdev/whitelist/index.md'
+ Download: `/docs/zh/edge/guide/hybrid/plugins/index.md'
+ Download: `/docs/zh/edge/guide/hybrid/webviews/index.md'
+ Download: `/docs/zh/edge/index.md'
+ Download: `/docs/zh/edge/config_ref/index.md'
+ Download: `/docs/zh/edge/plugin_ref/spec.md'
+ Download: `/docs/zh/edge/plugin_ref/plugman.md'
+ About to fix crowdin errors with resulting files
+ Done with crowdin fix
+ # On branch master
+ nothing to commit (working directory clean)
+ Everything up-to-date
+
+
+### Crowdin Error Debugging
+
+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.
+
+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.
+
+### 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
+
+~/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.
+
+### 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
+are only viewable from GitHub under the docs directory for each plugin.
+
+## Manual Steps
+
+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"
+
+### 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.
+
+### 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".
+
+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.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/86cd0951/docs/index.md
----------------------------------------------------------------------
diff --git a/docs/index.md b/docs/index.md
index 4ed315a..b04cabd 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -23,6 +23,7 @@ Release Process:
* [cadence-release-process.md](cadence-release-process.md)
* [plugins-release-process.md](plugins-release-process.md)
* [tools-release-process.md](tools-release-process.md)
+* [doc-translation-process.md](doc-translation-process.md)
Design:
* [storing-repo-versions-design.md](storing-repo-versions-design.md)
[7/7] git commit: Freshen the docs based on a recent release.
Posted by ld...@apache.org.
Freshen the docs based on a recent release.
- add quotes around operands in "if" statements to handle null values.
- update the version of the test plugin to match its parent version.
- use the curated release notes when grabbing text for the blog entry.
- update the local repo after a push so "repo-status" reports correctly.
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/ef830183
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/ef830183
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/ef830183
Branch: refs/heads/CB-7471
Commit: ef830183f15c5100e021dcf44aed42869a4005c9
Parents: 8a6b92e
Author: Marcel Kinard <cm...@gmail.com>
Authored: Wed Sep 17 18:17:07 2014 -0400
Committer: Marcel Kinard <cm...@gmail.com>
Committed: Wed Sep 17 18:17:07 2014 -0400
----------------------------------------------------------------------
docs/plugins-release-process.md | 20 ++++++++++++++------
1 file changed, 14 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/ef830183/docs/plugins-release-process.md
----------------------------------------------------------------------
diff --git a/docs/plugins-release-process.md b/docs/plugins-release-process.md
index d785ec2..b480dc2 100644
--- a/docs/plugins-release-process.md
+++ b/docs/plugins-release-process.md
@@ -81,13 +81,15 @@ TODO: Should not mention testing other than checking medic
## Update RELEASENOTES.md & Version
Remove the ''-dev'' suffix on the version in plugin.xml.
- for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; v2="${v%-dev}"; if [ $v != $v2 ]; then echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; v2="${v%-dev}"; if [ "$v" != "$v2" ]; then echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
If the changes merit it, manually bump the major / minor version instead of the micro. Manual process, but list the changes via:
for l in $ACTIVE; do ( cd $l; echo $l; git log --pretty=format:'* %s' --topo-order --no-merges $(git describe --tags --abbrev=0)..master | grep -v "Incremented plugin version" ); done
-For each of the plugins that have a test project inside it, update the version number there (cordova-plugin-*/tests/plugin.xml) to match the version of the plugin itself (cordova-plugin-*/plugin.xml).
+For each of the plugins that have a test project inside it, update the version number there (`cordova-plugin-*/tests/plugin.xml`) to match the version of the plugin itself (`cordova-plugin-*/plugin.xml`).
+
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; vt="$(grep version= tests/plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; if [ "$v" != "$vt" ]; then echo "$l: Setting version to $v"; sed -i '' -E s:"version=\"$vt\":version=\"$v\":" tests/plugin.xml; fi); done
Update its RELEASENOTES.md file with changes
@@ -97,15 +99,15 @@ Update its RELEASENOTES.md file with changes
# Then curate:
vim ${ACTIVE// //RELEASENOTES.md }/RELEASENOTES.md
-Print all changes for plugins (save this text for the blog post):
+Print the curated changes for plugins (save this text for the blog post, after deleting the unnecessary lines):
- for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; id=$(grep -o '\bid=\"[^\"]*\"' plugin.xml | head -n1 | cut -d'"' -f2); echo -e "\n\`$id@$v\`"; git log --pretty=format:'* %s' --topo-order --no-merges $(git describe --tags --abbrev=0)..master | grep -v "Incremented plugin version"); done
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; id=$(grep -o '\bid=\"[^\"]*\"' plugin.xml | head -n1 | cut -d'"' -f2); echo -e "\n\`$id@$v\`"; git diff -U0 RELEASENOTES.md | sed 's/^\+//' ); done
Add a comment to the JIRA issue with the output from:
for l in $ACTIVE; do ( cd $l; id="$(grep id= plugin.xml | grep -v xml | grep -v engine | grep -v param | head -1 | cut -d'"' -f2)"; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; echo $id@$v; awk "{ if (p) print } /$DATE/ { p = 1 } " < RELEASENOTES.md; echo); done
-Commit these two changes together
+Commit these changes together (plugin.xml, RELEASENOTES.md, tests/plugin.xml)
for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; git commit -am "$JIRA Updated version and RELEASENOTES.md for release $v"); done
@@ -119,7 +121,10 @@ Commit these two changes together
## Update version
- for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; v_no_dev="${v%-dev}"; if [ $v = $v_no_dev ]; then v2="$(echo $v|awk -F"." '{$NF+=1}{print $0RT}' OFS="." ORS="")-dev"; echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
+ # update the plugin
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; v_no_dev="${v%-dev}"; if [ "$v" = "$v_no_dev" ]; then v2="$(echo $v|awk -F"." '{$NF+=1}{print $0RT}' OFS="." ORS="")-dev"; echo "$l: Setting version to $v2"; sed -i '' -E s:"version=\"$v\":version=\"$v2\":" plugin.xml; fi) ; done
+ # update the nested test
+ for l in $ACTIVE; do ( cd $l; v="$(grep version= plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; vt="$(grep version= tests/plugin.xml | grep -v xml | head -n1 | cut -d'"' -f2)"; if [ "$v" != "$vt" ]; then echo "$l: Setting version to $v"; sed -i '' -E s:"version=\"$vt\":version=\"$v\":" tests/plugin.xml; fi); done
for l in $ACTIVE; do (cd $l; git commit -am "$JIRA Incremented plugin version." ); done
## Push tags and changes
@@ -128,6 +133,9 @@ Commit these two changes together
coho foreach -r plugins "git status -s"
# Push:
for l in $ACTIVE; do ( cd $l; git push --tags https://git-wip-us.apache.org/repos/asf/$l.git master); done
+ # Check that it was all successful:
+ coho repo-update -r plugins
+ coho repo-status -r plugins
## Publish to dist/dev
Ensure you have the svn repos checked out:
[2/7] git commit: Clarify the role of shrinkwrap. Other minor
improvements.
Posted by ld...@apache.org.
Clarify the role of shrinkwrap. Other minor improvements.
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/7792a80c
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/7792a80c
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/7792a80c
Branch: refs/heads/CB-7471
Commit: 7792a80c7e7f3a36d75ed907258547b2b445e948
Parents: 86cd095
Author: Marcel Kinard <cm...@gmail.com>
Authored: Tue Sep 16 09:18:28 2014 -0400
Committer: Marcel Kinard <cm...@gmail.com>
Committed: Tue Sep 16 09:19:11 2014 -0400
----------------------------------------------------------------------
docs/cadence-release-process.md | 12 +++++++-----
docs/tools-release-process.md | 2 +-
2 files changed, 8 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/7792a80c/docs/cadence-release-process.md
----------------------------------------------------------------------
diff --git a/docs/cadence-release-process.md b/docs/cadence-release-process.md
index 1323ce8..5b290cf 100644
--- a/docs/cadence-release-process.md
+++ b/docs/cadence-release-process.md
@@ -301,6 +301,8 @@ _Note: list of PMC members: http://people.apache.org/committers-by-project.html#
svn rm tools/cordova-lib*
svn rm tools/plugman-*
svn rm tools/cordova-3*
+ svn rm tools/cordova-app-hello*
+ svn rm tools/cordova-mobile-spec*
svn rm platforms/*
cp ../cordova-dist-dev/$JIRA/cordova-js* tools/
cp ../cordova-dist-dev/$JIRA/cordova-3* tools/
@@ -328,17 +330,17 @@ Note: when doing the `npm publish` make sure you are using a recent version of n
cd ../cordova-dist-dev/$JIRA
-publish all at once
+Publish all at once:
for package in $(find *.tgz); do $(npm publish --tag rc $package); done;
-publish one package at a time
+Or publish one package at a time:
npm publish --tag rc cordova-android-3.6.0.tgz
Note: You need to be an owner for each of these repos and the versions can't already have been published. You want to publish with the rc tag, so you can move everything to "latest" all at once after they have all been published.
-Do a quick test of the rc version
+Do a quick test of the rc version:
npm -g uninstall cordova
npm -g install cordova@rc
@@ -348,12 +350,12 @@ Do a quick test of the rc version
cordova plugin add org.apache.cordova.device
cordova run android
-Tag this new version in npm as the latest
+Tag this new version in npm as the latest:
npm tag cordova@3.6.0-0.2.8 latest
npm tag cordova-android@3.6.0 latest
-Repeat the tagging as "latest" for all the npm packages. You can check your work by running "npm info cordova-android" and look at the value for 'dist-tags'.
+Repeat the tagging as "latest" for all the npm packages (platforms and tools). You can check your work by running "npm info cordova-android" and look at the value for 'dist-tags'.
Note that it is not possible to remove the "rc" tag. But it should now point to the same place as "latest".
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/7792a80c/docs/tools-release-process.md
----------------------------------------------------------------------
diff --git a/docs/tools-release-process.md b/docs/tools-release-process.md
index c3e0970..ce05583 100644
--- a/docs/tools-release-process.md
+++ b/docs/tools-release-process.md
@@ -124,7 +124,7 @@ Update the version of cordova-lib that cli and plugman depend on:
sed -i '' -E 's/"cordova-lib":.*/"cordova-lib": "'$v'",/' cordova-cli/package.json
sed -i '' -E 's/"cordova.lib":.*/"cordova-lib": "'$v'",/' cordova-plugman/package.json
-Create npm-shrinkwrap.json in lib, cli, and plugman:
+Create npm-shrinkwrap.json in lib, cli, and plugman. This is important especially when the cli depends on specific versions of lib and similar, because the shrinkwrap overrules the version dependencies in package.json. If the tools have any specific version dependencies, verify they are correct in the shrinkwrap after you complete this step.
(cd cordova-lib/cordova-lib; npm shrinkwrap;)
(cd cordova-cli; npm shrinkwrap;)
[6/7] git commit: Capture some of the updated process for shrinkwrap
Posted by ld...@apache.org.
Capture some of the updated process for shrinkwrap
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/8a6b92e8
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/8a6b92e8
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/8a6b92e8
Branch: refs/heads/CB-7471
Commit: 8a6b92e855dab6475519b1cd78a1693b538b0292
Parents: a5decc8
Author: Marcel Kinard <cm...@gmail.com>
Authored: Wed Sep 17 18:15:52 2014 -0400
Committer: Marcel Kinard <cm...@gmail.com>
Committed: Wed Sep 17 18:15:52 2014 -0400
----------------------------------------------------------------------
docs/tools-release-process.md | 9 +++++++++
1 file changed, 9 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/8a6b92e8/docs/tools-release-process.md
----------------------------------------------------------------------
diff --git a/docs/tools-release-process.md b/docs/tools-release-process.md
index b3d9c78..c004d44 100644
--- a/docs/tools-release-process.md
+++ b/docs/tools-release-process.md
@@ -126,6 +126,15 @@ Update the version of cordova-lib that cli and plugman depend on:
Update the version of cordova-js that cordova-lib depends on. (TODO: why does this dependency exist?)
+Before creating the shrinkwrap, do the following so that the shrinkwrap will have the correct content.
+
+ * If you have used "npm link ..." across cordova dependencies, remove that. If you don't, then the devDependencies of the child module will be included in the dependent's shrinkwrap since the shrinkwrap process walks the node_modules directory tree instead of inspecting the package.json file of each dependency. Using npm link is great for development time, bad for packaging time. This should be taken care of in the `rm -r node_modules` step below.
+ * Clear the npm cache. If you don't then the `from` and `resolved` fields in the shrinkwrap may not be generated properly.
+ npm cache clear
+ * For each cordova module that you want to shrinkwrap, do a clean install of its dependencies. (TODO: at this point it appears I would first need to "npm publish cordova-js" before I could do a clean install of the cordova-lib dependencies and create the shrinkwrap for cordova-lib. And then the same to "npm publish cordova-lib" before I could do a clean install of the cordova-cli/cordova-plugman dependencies and create the shrinkwrap for cordova-cli and cordova-plugman).
+ rm -r node_modules
+ npm install
+
Create npm-shrinkwrap.json in lib, cli, and plugman. This is important especially when the cli depends on specific versions of lib and similar, because the shrinkwrap overrules the version dependencies in package.json. If the tools have any specific version dependencies, verify they are correct in the shrinkwrap after you complete this step.
(cd cordova-lib/cordova-lib; npm shrinkwrap;)
[3/7] git commit: Updated the version of gnode.
Posted by ld...@apache.org.
Updated the version of gnode.
This was breaking CI tests.
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/f2badeb8
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/f2badeb8
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/f2badeb8
Branch: refs/heads/CB-7471
Commit: f2badeb8913af84986b9af411ec5233ea93295ab
Parents: 7792a80
Author: Max Woghiren <ma...@gmail.com>
Authored: Tue Sep 16 15:36:39 2014 -0400
Committer: Max Woghiren <ma...@gmail.com>
Committed: Tue Sep 16 15:36:39 2014 -0400
----------------------------------------------------------------------
package.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/f2badeb8/package.json
----------------------------------------------------------------------
diff --git a/package.json b/package.json
index 4be040c..59b4bcf 100644
--- a/package.json
+++ b/package.json
@@ -9,7 +9,7 @@
"dependencies": {
"chalk": "~0.4",
"co": "~3.0",
- "gnode": "0.0.8",
+ "gnode": "^0.1.0",
"optimist": "0.4",
"q": "~0.9",
"request": "2.22.0",
[5/7] git commit: CB-7574 generate plugins as a zip archive instead
npm pack
Posted by ld...@apache.org.
CB-7574 generate plugins as a zip archive instead npm pack
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/a5decc8a
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/a5decc8a
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/a5decc8a
Branch: refs/heads/CB-7471
Commit: a5decc8a99712cc2fc28984e7d8ff85bae1a5d0a
Parents: 44f746d
Author: Marcel Kinard <cm...@gmail.com>
Authored: Wed Sep 17 17:34:36 2014 -0400
Committer: Marcel Kinard <cm...@gmail.com>
Committed: Wed Sep 17 17:34:36 2014 -0400
----------------------------------------------------------------------
src/create-verify-archive.js | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/a5decc8a/src/create-verify-archive.js
----------------------------------------------------------------------
diff --git a/src/create-verify-archive.js b/src/create-verify-archive.js
index 206b446..e0379b6 100644
--- a/src/create-verify-archive.js
+++ b/src/create-verify-archive.js
@@ -71,7 +71,7 @@ exports.createCommand = function*(argv) {
yield gitutil.gitCheckout(tag);
print('Creating archive of ' + repo.repoName + '@' + tag);
- if (!(repo.id==='mobile-spec' || repo.id==='app-hello-world')) {
+ if (!(repo.id==='mobile-spec' || repo.id==='app-hello-world' || repo.id.indexOf('plugin-')==0)) {
if (yield gitutil.pendingChangesExist()) {
apputil.fatal('Aborting because pending changes exist in ' + repo.repoName);
}
[4/7] git commit: Note that cordova-lib depends on cordova-js. Update
command for testing plugman.
Posted by ld...@apache.org.
Note that cordova-lib depends on cordova-js. Update command for testing plugman.
Project: http://git-wip-us.apache.org/repos/asf/cordova-coho/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-coho/commit/44f746d0
Tree: http://git-wip-us.apache.org/repos/asf/cordova-coho/tree/44f746d0
Diff: http://git-wip-us.apache.org/repos/asf/cordova-coho/diff/44f746d0
Branch: refs/heads/CB-7471
Commit: 44f746d09dbc6bd1e65c9f2f12a2ccdfdad4a50f
Parents: f2badeb
Author: Marcel Kinard <cm...@gmail.com>
Authored: Tue Sep 16 21:28:40 2014 -0400
Committer: Marcel Kinard <cm...@gmail.com>
Committed: Tue Sep 16 21:29:37 2014 -0400
----------------------------------------------------------------------
docs/tools-release-process.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-coho/blob/44f746d0/docs/tools-release-process.md
----------------------------------------------------------------------
diff --git a/docs/tools-release-process.md b/docs/tools-release-process.md
index ce05583..b3d9c78 100644
--- a/docs/tools-release-process.md
+++ b/docs/tools-release-process.md
@@ -82,7 +82,7 @@ Ensure uninstall doesn't cause errors:
Ensure that mobilespec creates okay via plugman:
- cordova-mobile-spec/createmobilespecandroid-usingplugman.sh
+ cordova-mobile-spec/createmobilespec/createmobilespec.js --plugman --android
(cd mobilespec-android && cordova/run)
Ensure unit tests pass:
@@ -124,6 +124,8 @@ Update the version of cordova-lib that cli and plugman depend on:
sed -i '' -E 's/"cordova-lib":.*/"cordova-lib": "'$v'",/' cordova-cli/package.json
sed -i '' -E 's/"cordova.lib":.*/"cordova-lib": "'$v'",/' cordova-plugman/package.json
+Update the version of cordova-js that cordova-lib depends on. (TODO: why does this dependency exist?)
+
Create npm-shrinkwrap.json in lib, cli, and plugman. This is important especially when the cli depends on specific versions of lib and similar, because the shrinkwrap overrules the version dependencies in package.json. If the tools have any specific version dependencies, verify they are correct in the shrinkwrap after you complete this step.
(cd cordova-lib/cordova-lib; npm shrinkwrap;)