Skip to content

Commit

Permalink
Editorial: rename spec to Geolocation (#164)
Browse files Browse the repository at this point in the history
  • Loading branch information
marcoscaceres committed Jun 15, 2024
1 parent 22ed7a4 commit a251654
Show file tree
Hide file tree
Showing 5 changed files with 49 additions and 50 deletions.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Spec development happens via [issues in this repository](https://github.com/w3c/geolocation-api/issues) and [pull requests](https://github.com/w3c/geolocation-api/pulls).
Spec development happens via [issues in this repository](https://github.com/w3c/geolocation/issues) and [pull requests](https://github.com/w3c/geolocation/pulls).

For normative changes, a corresponding [web-platform-tests](https://github.com/web-platform-tests/wpt) PR is highly appreciated. Typically, both PRs will be merged at the same time. If testing is not practical, please explain why and if appropriate [file an issue](https://github.com/web-platform-tests/wpt/issues/new) to follow up later.

Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Geolocation API
# Geolocation

Once a user grants permission, the Geolocation API provides access to geographical location information from device.
Once a user grants permission, Geolocation provides access to geographical location information from device.

- [Editor's draft](http://w3c.github.io/geolocation-api/)
- [Editor's draft](http://w3c.github.io/geolocation/)

## Examples of usage

Expand Down Expand Up @@ -80,4 +80,4 @@ sendPosition();

### More examples

The specification provides [examples](https://w3c.github.io/geolocation-api/#examples) covering different use case.
The specification provides [examples](https://w3c.github.io/geolocation/#examples) covering different use case.
12 changes: 6 additions & 6 deletions errata.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="utf-8" />
<title>Geolocation API Errata</title>
<title>Geolocation Errata</title>
<script
src="https://www.w3.org/Tools/respec/respec-w3c"
class="remove"
Expand Down Expand Up @@ -36,11 +36,11 @@
height:"48"
}
],
postProcess: [removeRedudantParts]
postProcess: [hideRedundantParts]
};
function removeRedudantParts() {
function hideRedundantParts() {
const details = document.querySelector("body > div.head > details");
details.classList.add("removeOnSave");
details.style = "display: none";
}
</script>
</head>
Expand All @@ -52,10 +52,10 @@

## Process for submitting errata

Please [file an issue](https://github.com/w3c/geolocation-api/issues/new) on Github.
Please [file an issue](https://github.com/w3c/geolocation/issues/new) on Github.

## Unaddressed errata
[See issues on Github](https://github.com/w3c/geolocation-api/labels/errata)
[See issues on Github](https://github.com/w3c/geolocation/labels/errata)

## Errata approved by the Working Group
<script class="removeOnSave">
Expand Down
69 changes: 34 additions & 35 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="color-scheme" content="light dark">
<title>
Geolocation API
Geolocation
</title>
<script src="https://www.w3.org/Tools/respec/respec-w3c" async class=
"remove"></script>
Expand Down Expand Up @@ -39,12 +39,12 @@
previousPublishDate: "2022-02-17",
crEnd: "2022-03-18",
previousMaturity: "CR",
github: "w3c/geolocation-api",
github: "w3c/geolocation",
caniuse: "geolocation",
testSuiteURI: "https://wpt.live/geolocation-API/",
implementationReportURI: "https://w3c.github.io/geolocation-api/reports/PR_imp_report.html",
testSuiteURI: "https://wpt.live/geolocation/",
implementationReportURI: "https://w3c.github.io/geolocation/reports/PR_imp_report.html",
xref: "web-platform",
errata: "https://w3c.github.io/geolocation-api/errata.html",
errata: "https://w3c.github.io/geolocation/errata.html",
latestVersion: "https://www.w3.org/TR/geolocation/",
};
</script>
Expand All @@ -53,8 +53,8 @@
"secure-contexts permissions-policy permissions hr-time html">
<section id="abstract">
<p>
The Geolocation API provides access to geographical location
information associated with the hosting device.
Geolocation provides access to geographical location information
associated with the hosting device.
</p>
</section>
<section id="sotd" class="updateable-rec">
Expand Down Expand Up @@ -83,18 +83,18 @@ <h2>
Introduction
</h2>
<p>
The <cite>Geolocation API</cite> defines a high-level interface to
location information associated only with the device hosting the
implementation. Common sources of location information include Global
Positioning System (GPS) and location inferred from network signals
such as IP address, RFID, WiFi and Bluetooth MAC addresses, and
GSM/CDMA cell IDs, as well as user input. The API itself is agnostic of
the underlying location information sources, and no guarantee is given
that the API returns the device's actual location.
<cite>Geolocation</cite> defines a high-level interface to location
information associated only with the device hosting the implementation.
Common sources of location information include Global Positioning
System (GPS) and location inferred from network signals such as IP
address, RFID, WiFi and Bluetooth MAC addresses, and GSM/CDMA cell IDs,
as well as user input. The API itself is agnostic of the underlying
location information sources, and no guarantee is given that the API
returns the device's actual location.
</p>
<p>
If an end user [=check permission|grants permission=], the
<cite>Geolocation API</cite>:
If an end user [=check permission|grants permission=],
<cite>Geolocation</cite>:
</p>
<ul>
<li>Provides location data as latitude, longitude, altitude, speed, and
Expand Down Expand Up @@ -325,15 +325,14 @@ <h3>
</h3>
<p>
The [=policy-controlled feature/default allowlist=] of `'self'`
allows Geolocation API usage in same-origin nested frames but
prevents third-party content from using the API.
allows API usage in same-origin nested frames but prevents
third-party content from using the API.
</p>
<p>
Third-party usage can be selectively enabled by adding the
[^iframe/allow^]`="geolocation"` attribute to an [^iframe^] element:
</p>
<aside class="example" title=
"Enabling the Geolocation API in an iframe">
<aside class="example" title="Enabling Geolocation in an iframe">
<pre class="html">
&lt;iframe
src="https://third-party.com"
Expand Down Expand Up @@ -371,10 +370,10 @@ <h3>
User consent
</h3>
<p>
The <cite>Geolocation API</cite> is a [=powerful feature=] that
requires [=express permission=] from an end-user before any location
data is shared with a web application. This requirement is
normatively enforced by the [=check permission=] steps on which the
<cite>Geolocation</cite> is a [=powerful feature=] that requires
[=express permission=] from an end-user before any location data is
shared with a web application. This requirement is normatively
enforced by the [=check permission=] steps on which the
{{Geolocation/getCurrentPosition()}} and
{{Geolocation/watchPosition()}} methods rely.
</p>
Expand Down Expand Up @@ -405,7 +404,7 @@ <h3>
<p class="note" title=
"Developers' responsibility with this sensitive data">
This section applies to "recipients", which generally means
developers utilizing the <cite>Geolocation API</cite>. Although it's
developers utilizing <cite>Geolocation</cite>. Although it's
impossible for the user agent, or this specification, to enforce
these requirements, developers need to read this section carefully
and do their best to adhere to the suggestions below. Developers need
Expand Down Expand Up @@ -465,8 +464,8 @@ <h2>
Checking permission to use the API
</h2>
<p>
The <cite>Geolocation API</cite> is a [=default powerful feature=]
identified by the [=powerful feature/name=] <code><dfn class=
<cite>Geolocation</cite> is a [=default powerful feature=] identified
by the [=powerful feature/name=] <code><dfn class=
"permission">"geolocation"</dfn></code>.
</p>
<p>
Expand All @@ -487,8 +486,8 @@ <h2>
Security considerations
</h2>
<p>
There are no security considerations associated with Geolocation API at
the time of publication. However, readers are advised to read the
There are no security considerations associated with Geolocation at the
time of publication. However, readers are advised to read the
[[[#privacy]]].
</p>
</section>
Expand Down Expand Up @@ -1238,8 +1237,8 @@ <h4>
</aside>
<aside class="addition" id="a3">
<span class="marker">Candidate Correction:</span> To improve clarity
and precision, a description of the accuracy attribute has been added,
defining it as meters of radius.
and precision, a description of the accuracy attribute has been
added, defining it as meters of radius.
</aside>
<p>
<del cite="#c3">The <strong>latitude</strong> and
Expand Down Expand Up @@ -1503,8 +1502,8 @@ <h2>
Change log
</h2>
<p>
Since First Public Working Draft in 2021, the <cite>Geolocation
API</cite> has received the following normative changes:
Since First Public Working Draft in 2021, <cite>Geolocation</cite> has
received the following normative changes:
</p>
<script class="removeOnSave">
function removeCommits(commit) {
Expand Down Expand Up @@ -1550,7 +1549,7 @@ <h2>
</ul>
<p>
See the <a href=
"https://github.com/w3c/geolocation-api/commits/gh-pages">commit
"https://github.com/w3c/geolocation/commits/gh-pages">commit
history</a> for a complete list of changes.
</p>
</section>
Expand Down
8 changes: 4 additions & 4 deletions reports/PR_imp_report.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,16 +28,16 @@
}
</style>
<title>
Geolocation API - implementation report 2016-2022
Geolocation - implementation report 2016-2022
</title>
</head>
<body>
<h1 id="title">
Geolocation API - implementation report 2016-2022
Geolocation - implementation report 2016-2022
</h1>
<section id='abstract'>
<p>
This is an implementation report for the Geolocation API, covering the
This is an implementation report for [[[geolocation]]], covering the
testable normative changes that were made since maintenance resumed on
the specification in 2016 until 2022.
</p>
Expand All @@ -46,7 +46,7 @@ <h2>
Tested assertions
</h2>
<p data-cite="permissions">
As the Geolocation API requires explicit permission grant to be used (via
As Geolocation requires explicit permission grant to be used (via
a browser UI), the following assertions were tested manually to assure
interoperability across user agents.
</p>
Expand Down

0 comments on commit a251654

Please sign in to comment.