Merge "docs: App Translation API updates" into mnc-docs

am: 1ede811143

* commit '1ede811143d32afe8ba6ce49a19060da4a1b6092':
  docs: App Translation API updates

Change-Id: Id075bdfddf3c5ccabf063690a37c487a87f9635d

docs/html/distribute/engage/_book.yaml

@@ -17,6 +17,9 @@ toc:
 - title: Encourage Competition
   path: /distribute/engage/game-services.html
 
+- title: Engage Users in Their Language
+  path: /distribute/engage/translate.html
+
 - title: Understand User Behavior
   path: /distribute/engage/analytics.html
 

docs/html/distribute/engage/engage_toc.cs

@@ -36,6 +36,12 @@
         <span class="en">Encourage Competition</span></a>
     </div>
   </li>
+  <li class="nav-section">
+    <div class="nav-section-header empty" style="font-weight:normal"><a href="<?cs
+        var:toroot?>distribute/engage/translate.html">
+        <span class="en">Engage Users in Their Language</span></a>
+    </div>
+  </li>
   <li class="nav-section">
     <div class="nav-section-header empty" style="font-weight:normal"><a href="<?cs
         var:toroot?>distribute/engage/analytics.html">

docs/html/distribute/engage/translate.jd

@@ -0,0 +1,91 @@
+page.title=Engage Users in Their Language
+page.metaDescription=Use the App Translation Service to maximize the amount of people who can install and engage with your app.
+page.tags="app translation service, translation, localization"
+page.image=/images/gp-listing-3.jpg
+
+@jd:body
+
+<div class="figure">
+  <img src="{@docRoot}images/gp-listing-3.jpg" style="width:512px;">
+</div>
+<p>
+  Translating your app's store description, user interface text, and in-app
+  purchase products into multiple languages maximizes the amount of people
+  who can install, engage with, and recommend it.
+</p>
+
+<div class="headerLine">
+  <h2 id="before-translation">Before You Translate</h2>
+</div>
+
+<p>
+  Translation is one of the final steps in localization. For more detailed
+  information about the localization process, refer to the following documentation:
+</p>
+
+<ul>
+  <li>
+    <a href="https://developer.android.com/distribute/tools/localization-checklist.html">
+    Localization Checklist</a>
+  </li>
+
+  <li>
+    <a href="http://developer.android.com/guide/topics/resources/localization.html">Localizing
+    with Resources</a>
+  </li>
+
+  <li>
+    <a href="http://developer.android.com/training/basics/supporting-devices/languages.html">
+    Supporting Different Languages</a>
+  </li>
+</ul>
+
+<div class="headerLine">
+  <h2 id="translate">How to Translate</h2>
+</div>
+
+<p>
+  While translating your store listing and universal app campaign ads (if you have any) can make
+  your app more discoverable, providing a translated user interface and in-app purchase products
+  can maximize user engagement and retention. Depending on your budget, there are several
+  options available:
+</p>
+
+<ul>
+  <li>
+    <strong>Use the Google Play App Translation Service</strong>: For your convenience, Google Play
+    provides an <a href="https://support.google.com/l10n/answer/6359997">App Translation Service</a>
+    that is integrated directly into the <a href="https://support.google.com/l10n/answer/6341304">
+    Developer Console</a> and <a href="https://support.google.com/l10n/answer/6341928">Android
+    Studio</a>. Using this professional, human service, you can order translations for your app,
+    store listing text, in-app purchase products, and universal app campaign ads all in one go.
+    You’ll get instant estimates from multiple vendors, all with the convenience of ordering and
+    paying online.
+  </li>
+
+  <li>
+    <strong>Do it yourself</strong>: If you or your colleagues know the target languages, you can
+    translate everything yourself using any text editor, or you can use the
+    <a href="http://tools.android.com/recent/androidstudio087released">Android Studio Translation
+    Editor</a>.
+  </li>
+
+  <li>
+    <strong>Use a third-party translation service</strong>: You can use a translation service
+    that is offered by one of the many translation companies available online.
+  </li>
+</ul>
+
+<p style="clear:both">
+</p>
+
+<div class="headerLine">
+  <h2 id="related-resources">Related Resources</h2>
+</div>
+
+<div class="resource-widget resource-flow-layout col-13"
+  data-query="collection:distribute/engage/translate"
+  data-sortorder="-timestamp"
+  data-cardsizes="9x3"
+  data-maxresults="6">
+</div>

docs/html/distribute/tools/localization-checklist.jd

@@ -530,19 +530,17 @@ data-sortorder="-timestamp" data-cardsizes="9x3" data-maxresults="6">
 </h4>
 
 <p>
-  Google Play App Translation Service can help you quickly find and purchase
+  The <a href="https://support.google.com/l10n/answer/6359997">App Translation
-  translations of your app. In the Developer Console, you can browse a list of
+  Service</a> can help you quickly purchase translations of your app. In the
-  third-party vendors who are pre-qualified by Google to offer high-quality
+  Developer Console and Android Studio, you get instant quotes from a list of
-  translation at competitive prices. You can upload the strings you want
+  third-party translation vendors. Beyond the app UI strings, your order can
-  translated, select the languages you want to translate into, and select your
+  include translations for Play Store text, IAP names, and ad text.
-  translation vendor based on time and price.
 </p>
 
 <p>
-  Once you've purchased translations, you'll receive an email from your vendor.
+  Your translation order is a direct agreement between you and your chosen
-  Your translations are a direct business agreement between you and your
+  vendor. The vendor will work directly with you to provide clarification and
-  vendor; you'll need to work directly with the vendor to manage the
+  resolve any issues during the translation process.
-  translation process and deliverables and resolve any support issues.
 </p>
 
 <div>
@@ -736,10 +734,12 @@ data-sortorder="-timestamp" data-cardsizes="9x3" data-maxresults="6">
     </h2>
 
     <p>
-      You can use the App Translation service on Google Play to translate your
+      You can use the <a href=
-      store listing. Prepare an XML file with your store listing information
+      "https://support.google.com/l10n/answer/6359997">App Translation
-      and upload just as you would upload the strings.xml file (see <a href=
+      Service</a> on Google Play to translate your store listing. You can use
-      "#gp-trans">Purchase professional translations</a>)
+      your existing published store listing text as the source or edit it
+      online before placing your order (see <a href="#gp-trans">Purchase
+      professional translations</a>).
     </p>
   </div>
 </div>

docs/html/distribute/users/expand-to-new-markets.jd

@@ -116,12 +116,20 @@ page.tags="users, growth, global"
   Localization</a> section of the Localization Checklist.
 </p>
 
+<h3>
+  Purchase professional translations through Google Play
+</h3>
+
 <p>
-  <strong>Google Play App Translation Service</strong> can help you quickly
+  The <a href="https://support.google.com/l10n/answer/6359997">App Translation
-  find and purchase translations of your apps. In the <a href=
+  Service</a> can help you quickly purchase translations of your app. In the
-  "https://play.google.com/apps/publish/">Developer Console</a>, you can browse
+  <a href="https://support.google.com/l10n/answer/6341304">Developer
-  a list of third-party vendors who are pre-qualified by Google to offer
+  Console</a> and <a href=
-  high-quality professional translations at competitive prices.
+  "https://support.google.com/l10n/answer/6341928">Android Studio</a>, you can
+  browse a list of third-party vendors who are prequalified by Google to offer
+  high-quality translations at competitive prices. Beyond the app UI strings,
+  you can request translations for Play Store text, in-app purchase products,
+  and universal app campaign ads, all in one go.
 </p>
 
 <img src="{@docRoot}images/gp-listing-3.jpg" style="padding:8px 0">

docs/html/guide/topics/resources/localization.jd

@@ -33,6 +33,7 @@ Providing Resources</a></li>
 Layouts</a></li>
 <li><a href="{@docRoot}reference/android/app/Activity.html#ActivityLifecycle">
 Activity Lifecycle</a></li>
+<li><a href="https://support.google.com/l10n/answer/6359997">App Translation Service</a></li>
 </ol>
 </div>
 </div>
@@ -395,6 +396,20 @@ defined in <code>res/values/strings.xml</code>.</p>
 that Android makes available:</p>
 
 <pre>String locale = context.getResources().getConfiguration().locale.getDisplayName();</pre>
+<h4>
+  Use the App Translation Service
+</h4>
+
+<p>
+  The <a href="https://support.google.com/l10n/answer/6359997">App Translation
+  Service</a> is integrated into the <a href=
+  "https://support.google.com/l10n/answer/6341304">Developer Console</a>, and
+  it is also accessible from <a href=
+  "https://support.google.com/l10n/answer/6341928">Android Studio</a>. It is a
+  quick and simple way to get an instant quote and place an order with a
+  translation company. You can order translations into one or more languages
+  for app UI strings, Play Store Listing text, IAP names, and ad campaign text.
+</p>
 
 <h2 id="testing">Testing Localized Applications</h2>
 

docs/html/jd_collections.js

@@ -395,6 +395,7 @@ var RESOURCE_COLLECTIONS = {
     "resources": [
       "distribute/engage/intents.html",
       "distribute/engage/widgets.html",
+      "distribute/engage/translate.html",
       "distribute/engage/notifications.html",
       "distribute/engage/deep-linking.html",
       "distribute/engage/ads.html",
@@ -1061,6 +1062,12 @@ var RESOURCE_COLLECTIONS = {
       "guide/topics/appwidgets/index.html"
     ]
   },
+  "distribute/engage/translate": {
+    "title": "",
+    "resources": [
+      "https://support.google.com/l10n/answer/6359997"
+    ]
+  },
   "distribute/engage/reengage": {
     "title": "",
     "resources": [
@@ -1313,7 +1320,8 @@ var RESOURCE_COLLECTIONS = {
   "distribute/toolsreference/launchchecklist/localization": {
     "title": "",
     "resources": [
-      "distribute/tools/localization-checklist.html"
+      "distribute/tools/localization-checklist.html",
+      "https://support.google.com/l10n/answer/6359997"
     ]
   },
   "distribute/toolsreference/launchchecklist/graphics": {

docs/html/jd_extras.js

@@ -2754,6 +2754,27 @@ DISTRIBUTE_RESOURCES = DISTRIBUTE_RESOURCES.concat([
     "type": "distribute",
     "titleFriendly": ""
   },
+  {
+    "lang": "en",
+    "group": "",
+    "tags": [
+      "marketing",
+      "engagement",
+      "translate"
+    ],
+    "url": "https://support.google.com/l10n/answer/6359997",
+    "timestamp": null,
+    "image": "images/play_dev.jpg",
+    "title": "Use the App Translation Service",
+    "summary": "The App Translation Service is a human translation service. It makes it easy to order translations for app UI strings, Play Store text, in-app purchase products, and universal app campaign ads.",
+    "keywords": [
+      "marketing",
+      "engagement",
+      "translate"
+    ],
+    "type": "distribute",
+    "titleFriendly": ""
+  },
   {
     "lang": "en",
     "group": "",

docs/html/jd_extras_en.js

@@ -2680,6 +2680,27 @@ METADATA['en'].extras = METADATA['en'].extras.concat([
     "type": "distribute",
     "category": "google"
   },
+  {
+    "lang": "en",
+    "group": "",
+    "tags": [
+      "marketing",
+      "engagement",
+      "translate"
+    ],
+    "url": "https://support.google.com/l10n/answer/6359997",
+    "timestamp": null,
+    "image": "images/play_dev.jpg",
+    "title": "Use the App Translation Service",
+    "summary": "The App Translation Service is a human translation service. It makes it easy to order translations for app UI strings, Play Store text, in-app purchase products, and universal app campaign ads.",
+    "keywords": [
+      "marketing",
+      "engagement",
+      "translate"
+    ],
+    "type": "distribute",
+    "titleFriendly": ""
+  },
   {
     "lang": "en",
     "group": "",
@@ -3923,6 +3944,7 @@ METADATA['en'].collections = {
     "resources": [
       "distribute/engage/intents.html",
       "distribute/engage/widgets.html",
+      "distribute/engage/translate.html",
       "distribute/engage/notifications.html",
       "distribute/engage/deep-linking.html",
       "distribute/engage/ads.html",
@@ -4537,6 +4559,12 @@ METADATA['en'].collections = {
       "guide/topics/appwidgets/index.html"
     ]
   },
+  "distribute/engage/translate": {
+    "title": "",
+    "resources": [
+      "https://support.google.com/l10n/answer/6359997"
+    ]
+  },
   "distribute/engage/reengage": {
     "title": "",
     "resources": [

docs/html/training/basics/supporting-devices/languages.jd

@@ -19,6 +19,7 @@ trainingnavtop=true
     <ul>
     <li><a href="{@docRoot}distribute/tools/localization-checklist.html">Localization Checklist</a></li>
       <li><a href="{@docRoot}guide/topics/resources/localization.html">Localization with Resources</a></li>
+      <li><a href="https://support.google.com/l10n/answer/6359997">App Translation Service</a></li>
     </ul>
   </div>
 </div>