Docs: Changes to source.android.com

  - 209604809 Add note about dm-verity for low-ram devices where it onl... by Danielle Roberts <daroberts@google.com>
  - 209604691 Update August acknowledgements for CVE-2018-9441 by Danielle Roberts <daroberts@google.com>
  - 209486466 Add LEVEL_3 to Camera versioning by Kenneth Lau <kennethlau@google.com>
  - 209486462 CL to update external severity ratings to the v6 severity... by Android Partner Docs <noreply@android.com>
  - 209444238 Update _translation.yaml to exclude 2018 bulletins by Danielle Roberts <daroberts@google.com>
  - 209427959 Add arrow icon to external links in lists by Kenneth Lau <kennethlau@google.com>
  - 209424658 Devsite localized content from translation request 968451. by Android Partner Docs <noreply@android.com>
  - 209424637 Devsite localized content from translation request 968450. by Android Partner Docs <noreply@android.com>
  - 209424628 Devsite localized content from translation request 966380. by Android Partner Docs <noreply@android.com>
  - 209424625 Devsite localized content from translation request 964306. by Android Partner Docs <noreply@android.com>
  - 209267798 Replaces gendered pronouns by a gender-neutral alternative. by Android Partner Docs <noreply@android.com>
  - 209227647 Devsite localized content from translation request 965625. by Android Partner Docs <noreply@android.com>
  - 209227634 Devsite localized content from translation request 957852. by Android Partner Docs <noreply@android.com>
  - 209212984 Adding additional kernel configs by Heidi von Markham <hvm@google.com>
  - 209202145 Fix typo by Kenneth Lau <kennethlau@google.com>
  - 209200899 Change to external links by Kenneth Lau <kennethlau@google.com>
  - 209199945 Add links to Wi-Fi Infrastructure Features by Kenneth Lau <kennethlau@google.com>
  - 209197210 Update BiometricPrompt architecture diagram by Danielle Roberts <daroberts@google.com>
  - 209175201 Add missing method handle types to dex-format.html by Android Partner Docs <noreply@android.com>
  - 209168733 Fix formatting issues by Kenneth Lau <kennethlau@google.com>
  - 209045992 Remove "" typo that's causing localization to break by Danielle Roberts <daroberts@google.com>
  - 209045924 Remove "" typo that's causing localization to fail by Danielle Roberts <daroberts@google.com>
  - 209045830 Update header id that's causing localization failures by Danielle Roberts <daroberts@google.com>
  - 209042219 Update documentation for no more static java libraries. by Android Partner Docs <noreply@android.com>
  - 209031438 Remove previously redirected landing pages by Clay Murphy <claym@google.com>
  - 209023482 Add a additional kernel requirement information for eBPF ... by Android Partner Docs <noreply@android.com>
  - 209011451 Clarify documentation on conventions for method overloadi... by Android Partner Docs <noreply@android.com>
  - 208971152 Create a BLE for Hearing Aids page on SAC. by Christina Nguyen <cqn@google.com>
  - 208933222 Add "Matching AVB Version during OTA" section. by Android Partner Docs <noreply@android.com>
  - 208891110 Update correct version for CTS 7.0_r24. Wrong version was... by Android Partner Docs <noreply@android.com>
  - 208878378 Update CTS/CTS-Verifier downloads for CTS-Aug-2018 Releas... by Android Partner Docs <noreply@android.com>
  - 208855756 Devsite localized content from translation request 965636. by Android Partner Docs <noreply@android.com>
  - 208855746 Devsite localized content from translation request 964314. by Android Partner Docs <noreply@android.com>
  - 208738524 Add version information by Kenneth Lau <kennethlau@google.com>
  - 208733023 Update security researcher acknowledgements by Danielle Roberts <daroberts@google.com>
  - 208724203 Fix changelog links, messed up in last errata run. by Gina Dimino <gdimino@google.com>
  - 208723122 Add missing word "Android" by Android Partner Docs <noreply@android.com>
  - 208700832 Devsite localized content from translation request 954736. by Android Partner Docs <noreply@android.com>
  - 208688134 Devsite localized content from translation request 960242. by Android Partner Docs <noreply@android.com>
  - 208688127 Devsite localized content from translation request 952102. by Android Partner Docs <noreply@android.com>
  - 208672491 Fix file paths in immediate directory that were broken by... by Christina Nguyen <cqn@google.com>
  - 208571761 Add Wi-Fi Infrastructure Features document by Kenneth Lau <kennethlau@google.com>

PiperOrigin-RevId: 209604809
Change-Id: If554e158c7c400736ca7722cce279231a53e0933

1 files changed, 7 insertions, 5 deletions

diff --git a/en/devices/architecture/hidl/versioning.html b/en/devices/architecture/hidl/versioning.html
index c67910d9..fe4ec95d 100644
--- a/en/devices/architecture/hidl/versioning.html
+++ b/en/devices/architecture/hidl/versioning.html
@@ -219,7 +219,7 @@ as a method parameter), use the fully-qualified type name:</p>
 (e.g., <code>android.hardware.nfc</code>).</li>
 <li><code><var>VERSION</var></code> is the dot-separated major.minor-version
 format of the package (e.g., <code>1.0</code>).</li>
-<li><code><var>UDT</var></code> is the the dot-separated name of a HIDL UDT.
+<li><code><var>UDT</var></code> is the dot-separated name of a HIDL UDT.
 Since HIDL supports nested UDTs and HIDL interfaces can contain UDTs (a type of
 nested declaration), dots are used to access the names.</li>
 </ul>
@@ -656,10 +656,12 @@ enum Brightness : @1.0::Brightness { AUTOMATIC };
 enum Color : @1.0::Brightness { HW_GREEN, RAINBOW };
 </pre>
 
-<p>Unless a method warrants a new name, it should be named similarly to what it
-is extending. For example, the method <code>foo_1_1</code> in
-<code>@1.1::IFoo</code> may replace the functionality of the <code>foo</code>
-method in <code>@1.0::IFoo</code>.</p>
+<p>If a method can have a new semantic name (for instance
+<code>fooWithLocation</code>) then that is preferred. Otherwise, it should be
+named similarly to what it is extending. For example, the method
+<code>foo_1_1</code> in <code>@1.1::IFoo</code> may replace the functionality
+of the <code>foo</code> method in <code>@1.0::IFoo</code> if there is no better
+alternative name.</p>
 
 <h2 id=package-ext>Package-level versioning</h2>
 <p>HIDL versioning occurs at the package level; after a package is published, it