Document Android location accuracy requirements - #636
Open
jonathanpeppers wants to merge 2 commits into
Open
Conversation
Refs #104 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
jonathanpeppers
requested review from
dalexsoto
and
a lite review from Copilot
August 17, 2026 13:19
jonathanpeppers
enabled auto-merge (squash)
August 17, 2026 13:20
There was a problem hiding this comment.
Pull request overview
This PR updates the API reference XML for Android.Locations.Accuracy to replace placeholder member documentation with descriptions aligned to android.location.Criteria accuracy requirement constants, while keeping the AOSP attribution paragraphs in each member entry.
Changes:
- Replaced
To be added.placeholders with summaries forCoarse,Fine,High,Low, andNoRequirement. - Kept the existing Android Open Source Project / CC BY 2.5 attribution block for each updated member.
Suppressed comments (2)
docs/xml/Android.Locations/Accuracy.xml:68
- “location-accuracy” is an uncommon/awkward compound here and doesn’t match typical wording elsewhere in the docs. Prefer “location accuracy” without the hyphen.
<summary ToolPath="Untrimmed" tool="FirstSentenceInJavadocToMdoc">Indicates a fine location-accuracy requirement.</summary>
docs/xml/Android.Locations/Accuracy.xml:125
- This summary contains multiple sentences (and is flagged TrimmedButTooLong). To keep
concise (first sentence) and improve readability, move the extra detail into as a separate .
<summary ToolPath="TrimmedButTooLong" tool="FirstSentenceInJavadocToMdoc">Indicates a low location-accuracy requirement. It may be used for horizontal, altitude, speed, or bearing accuracy. For horizontal and vertical position, it corresponds roughly to an accuracy greater than 500 meters.</summary>
<remarks>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Refs #104 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Member
Author
|
@dalexsoto review |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Android.Locations.Accuracyvalues mapped fromandroid.location.Criteria.Sources
Criteria.java(ACCURACY_COARSE,ACCURACY_FINE,ACCURACY_HIGH,ACCURACY_LOW, andNO_REQUIREMENT)Validation
docs/xml/Android.Locations/Accuracy.xmlas XML.Refs #104