Skip to content

Commit bfb5325

Browse files
marcoscaceresmarcoscaceres
committed
chore: add correction/addition descriptions
1 parent 561c0ef commit bfb5325

File tree

1 file changed

+182
-49
lines changed

1 file changed

+182
-49
lines changed

‎index.html‎

Lines changed: 182 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -46,19 +46,6 @@
4646
errata: "https://w3c.github.io/geolocation-api/errata.html",
4747
};
4848
</script>
49-
<style>
50-
* {
51-
counter-reset: addition correction;
52-
}
53-
.addition::before {
54-
content: "Candidate Addition:";
55-
counter-increment: addition;
56-
}
57-
.correction::before {
58-
content: "Candidate Correction:";
59-
counter-increment: correction;
60-
}
61-
</style>
6249
</head>
6350
<body data-cite=
6451
"secure-contexts permissions-policy permissions hr-time html">
@@ -599,8 +586,26 @@ <h2>
599586
method steps are:
600587
</p>
601588
<ol class="algorithm">
602-
<li>If the [=this=]'s [=relevant global object=]'s [=associated
603-
`Document`=] is not [=Document/fully active=]:
589+
<li>
590+
<div class="correction">
591+
<span class="marker">Candidate Correction:</span> Explanation of
592+
the change: Updated reference to the global object to use
593+
[=this=] for consistency in error handling within geolocation
594+
retrieval.
595+
<blockquote>
596+
<ol>
597+
<li>
598+
<del>If the [=current settings object=]'s [=relevant global
599+
object=]'s [=associated `Document`=] is not
600+
[=Document/fully active=]:</del> <ins>If the [=this=]'s
601+
[=relevant global object=]'s [=associated `Document`=] is
602+
not [=Document/fully active=]:</ins>
603+
</li>
604+
</ol>
605+
</blockquote>
606+
</div>
607+
<!--If the [=this=]'s [=relevant global object=]'s [=associated
608+
`Document`=] is not [=Document/fully active=]:-->
604609
<ol>
605610
<li>[=Call back with error=] |errorCallback| and
606611
{{GeolocationPositionError/POSITION_UNAVAILABLE}}.
@@ -625,8 +630,25 @@ <h2>
625630
method steps are:
626631
</p>
627632
<ol class="algorithm">
628-
<li>If the [=this=]'s [=relevant global object=]'s [=associated
629-
`Document`=] is not [=Document/fully active=]:
633+
<li>
634+
<div class="correction">
635+
<span class="marker">Candidate Correction:</span> Explanation of
636+
the change: Simplified reference to the global object in the
637+
method steps for checking document's activity status.
638+
<blockquote>
639+
<ol>
640+
<li>
641+
<del>If the [=current settings object=]'s [=relevant global
642+
object=]'s [=associated `Document`=] is not
643+
[=Document/fully active=]:</del> <ins>If the [=this=]'s
644+
[=relevant global object=]'s [=associated `Document`=] is
645+
not [=Document/fully active=]:</ins>
646+
</li>
647+
</ol>
648+
</blockquote>
649+
</div>
650+
<!-- If the [=this=]'s [=relevant global object=]'s [=associated
651+
`Document`=] is not [=Document/fully active=]:-->
630652
<ol>
631653
<li>[=Call back with error=] passing |errorCallback| and
632654
{{GeolocationPositionError/POSITION_UNAVAILABLE}}.
@@ -1011,7 +1033,7 @@ <h2>
10111033
interface GeolocationPosition {
10121034
readonly attribute GeolocationCoordinates coords;
10131035
readonly attribute EpochTimeStamp timestamp;
1014-
[Default] object toJSON();
1036+
[Default] object toJSON();
10151037
};
10161038
</pre>
10171039
<section>
@@ -1031,14 +1053,21 @@ <h3>
10311053
geographic position of the device was acquired.
10321054
</p>
10331055
</section>
1034-
<section class="addition">
1056+
<section>
10351057
<h3>
10361058
`toJSON()` method
10371059
</h3>
1038-
<p>
1039-
The <dfn>toJSON()</dfn> method returns a JSON representation of the
1040-
{{GeolocationPosition}} object.
1041-
</p>
1060+
<div class="addition">
1061+
<span class="marker">Candidate Addition:</span> Explanation of the
1062+
addition: Introduce a `toJSON()` method to allow the
1063+
{{GeolocationPosition}} object to be easily converted into a JSON
1064+
representation, facilitating interoperability and ease of use in web
1065+
applications.
1066+
<p>
1067+
The <dfn>toJSON()</dfn> method returns a JSON representation of the
1068+
{{GeolocationPosition}} object.
1069+
</p>
1070+
</div>
10421071
</section>
10431072
<section>
10441073
<h2>
@@ -1109,15 +1138,20 @@ <h2>
11091138
<h4>
11101139
`latitude`, `longitude`, and `accuracy` attributes
11111140
</h4>
1112-
<p class="correction">
1113-
The <dfn>latitude</dfn> and <dfn>longitude</dfn> attributes denote
1114-
the position, specified as a real number of degrees, in the [[WGS84]]
1115-
coordinate system.
1116-
</p>
1117-
<p>
1118-
The <dfn>accuracy</dfn> attribute denotes the accuracy level of the
1119-
latitude and longitude coordinates in meters (e.g., `65` meters).
1120-
</p>
1141+
<div class="correction">
1142+
<span class="marker">Candidate Correction:</span> To improve clarity
1143+
and precision, the description of latitude and longitude attributes
1144+
has been updated to specify that these are real numbers in degrees
1145+
according to the [[WGS84]] geodetic system, instead of just stating
1146+
"decimal degrees."
1147+
<p>
1148+
<del>The <strong>latitude</strong> and <strong>longitude</strong>
1149+
attributes are geographic coordinates specified in decimal
1150+
degrees.</del> <ins>The <dfn>latitude</dfn> and
1151+
<dfn>longitude</dfn> attributes denote the position, specified as a
1152+
real number of degrees, in the [[WGS84]] coordinate system.</ins>
1153+
</p>
1154+
</div>
11211155
</section>
11221156
<section>
11231157
<h4>
@@ -1152,14 +1186,21 @@ <h4>
11521186
meters per second.
11531187
</p>
11541188
</section>
1155-
<section class="addition">
1189+
<section>
11561190
<h4>
11571191
`toJSON()` method
11581192
</h4>
1159-
<p>
1160-
The <dfn>toJSON()</dfn> method returns a JSON representation of the
1161-
{{GeolocationCoordinates}} object.
1162-
</p>
1193+
<div class="addition">
1194+
<span class="marker">Candidate Addition:</span> Explanation of the
1195+
addition: Extend the `toJSON()` method functionality to the
1196+
{{GeolocationCoordinates}} object, allowing it to be serialized into
1197+
a JSON format which enhances data handling and integration
1198+
capabilities in web applications.
1199+
<p>
1200+
The <dfn>toJSON()</dfn> method returns a JSON representation of the
1201+
{{GeolocationCoordinates}} object.
1202+
</p>
1203+
</div>
11631204
</section>
11641205
<section>
11651206
<h2>
@@ -1174,45 +1215,137 @@ <h2>
11741215
<li>Let |coords:GeolocationCoordinates| be a newly created
11751216
{{GeolocationCoordinates}} instance:
11761217
<ol>
1177-
<li class="correction">Initialize |coord|'s
1218+
<li>
1219+
<div class="correction">
1220+
<span class="marker">Candidate Correction:</span> Enhanced
1221+
the constructor steps for {{GeolocationCoordinates}} to
1222+
clarify the units and reference systems for latitude,
1223+
longitude, and altitude, ensuring consistency with the
1224+
updated attribute definitions.
1225+
<p>
1226+
Initialize |coord|'s {{GeolocationCoordinates/latitude}}
1227+
<del>attribute to a geographic coordinate in decimal
1228+
degrees.</del> <ins>attribute to a latitude, specified as a
1229+
real number of degrees, in the [[WGS84]] coordinate
1230+
system.</ins>
1231+
</p>
1232+
<p>
1233+
Initialize |coord|'s {{GeolocationCoordinates/longitude}}
1234+
<del>attribute to a geographic coordinate in decimal
1235+
degrees.</del> <ins>attribute to a longitude, specified as
1236+
a real number of degrees, in the [[WGS84]] coordinate
1237+
system.</ins>
1238+
</p>
1239+
<p>
1240+
Initialize |coord|'s {{GeolocationCoordinates/altitude}}
1241+
<del>attribute in meters above the [[WGS84]] ellipsoid, or
1242+
`null` if the implementation cannot provide altitude
1243+
information.</del> <ins>attribute to a height, in meters,
1244+
above the [[WGS84]] ellipsoid, or `null` if the
1245+
implementation cannot provide altitude information.</ins>
1246+
</p>
1247+
</div>
1248+
</li>
1249+
<li>
1250+
<div class="correction">
1251+
<span class="marker">Candidate Correction:</span> Updates to
1252+
the descriptions of the speed and heading attributes to
1253+
specify measurement units and conditions for null values,
1254+
aligning with the overall enhancements to attribute accuracy
1255+
and clarity.
1256+
<p>
1257+
Initialize |coord|'s {{GeolocationCoordinates/speed}}
1258+
<del>attribute to a non-negative real number, or as `null`
1259+
if the implementation cannot provide speed
1260+
information.</del> <ins>attribute to a speed, as a
1261+
non-negative real number of meters per second, or as `null`
1262+
if the implementation cannot provide speed
1263+
information.</ins>
1264+
</p>
1265+
<p>
1266+
Initialize |coord|'s {{GeolocationCoordinates/heading}}
1267+
<del>attribute in degrees, or `null` if the implementation
1268+
cannot provide heading information. If the hosting device
1269+
is stationary (i.e., the value of the
1270+
{{GeolocationCoordinates/speed}} attribute is 0), then
1271+
initialize the {{GeolocationCoordinates/heading}} to
1272+
`NaN`.</del> <ins>attribute to a heading, in degrees, or
1273+
`null` if the implementation cannot provide heading
1274+
information. If the hosting device is stationary (i.e., the
1275+
value of the {{GeolocationCoordinates/speed}} attribute is
1276+
0), then initialize the {{GeolocationCoordinates/heading}}
1277+
to `NaN`.</ins>
1278+
</p>
1279+
</div>
1280+
</li>
1281+
<li>
1282+
<div class="correction">
1283+
<span class="marker">Candidate Correction:</span> Updates to
1284+
the descriptions of the speed and heading attributes to
1285+
specify measurement units and conditions for null values,
1286+
aligning with the overall enhancements to attribute accuracy
1287+
and clarity.
1288+
<p>
1289+
Initialize |coord|'s {{GeolocationCoordinates/speed}}
1290+
<del>attribute to a non-negative real number, or as `null`
1291+
if the implementation cannot provide speed
1292+
information.</del> <ins>attribute to a speed, as a
1293+
non-negative real number of meters per second, or as `null`
1294+
if the implementation cannot provide speed
1295+
information.</ins>
1296+
</p>
1297+
<p>
1298+
Initialize |coord|'s {{GeolocationCoordinates/heading}}
1299+
<del>attribute in degrees, or `null` if the implementation
1300+
cannot provide heading information. If the hosting device
1301+
is stationary (i.e., the value of the
1302+
{{GeolocationCoordinates/speed}} attribute is 0), then
1303+
initialize the {{GeolocationCoordinates/heading}} to
1304+
`NaN`.</del> <ins>attribute to a heading, in degrees, or
1305+
`null` if the implementation cannot provide heading
1306+
information. If the hosting device is stationary (i.e., the
1307+
value of the {{GeolocationCoordinates/speed}} attribute is
1308+
0), then initialize the {{GeolocationCoordinates/heading}}
1309+
to `NaN`.</ins>
1310+
</p>
1311+
</div>
1312+
</li><!--li>Initialize |coord|'s
11781313
{{GeolocationCoordinates/latitude}} attribute to a latitude,
11791314
specified as a real number of degrees, in the [[WGS84]]
11801315
coordinate system.
1181-
</li>
1182-
<li class="correction">Initialize |coord|'s
1316+
</li-->
1317+
<!--li>Initialize |coord|'s
11831318
{{GeolocationCoordinates/longitude}} attribute to a longitude,
11841319
specified as a real number of degrees, in the [[WGS84]]
11851320
coordinate system.
1186-
</li>
1321+
</li-->
11871322
<li>Initialize |coord|'s {{GeolocationCoordinates/accuracy}}
11881323
attribute to a non-negative real number. The value SHOULD
11891324
correspond to a 95% confidence level with respect to the
11901325
longitude and latitude values.
1191-
</li>
1192-
<li class="correction">Initialize |coord|'s
1326+
</li><!--li>Initialize |coord|'s
11931327
{{GeolocationCoordinates/altitude}} attribute to a height, in
11941328
meters, above the [[WGS84]] ellipsoid, or `null` if the
11951329
implementation cannot provide altitude information.
1196-
</li>
1330+
</li-->
11971331
<li>Initialize |coord|'s
11981332
{{GeolocationCoordinates/altitudeAccuracy}} attribute as
11991333
non-negative real number, or to `null` if the implementation
12001334
cannot provide altitude information. If the altitude accuracy
12011335
information is provided, it SHOULD correspond to a 95% confidence
12021336
level.
1203-
</li>
1204-
<li class="correction">Initialize |coord|'s
1337+
</li><!--li>Initialize |coord|'s
12051338
{{GeolocationCoordinates/speed}} attribute to a speed, as a
12061339
non-negative real number of meters per second, or as `null` if
12071340
the implementation cannot provide speed information.
1208-
</li>
1209-
<li class="correction">Initialize |coord|'s
1341+
</li-->
1342+
<!--li>Initialize |coord|'s
12101343
{{GeolocationCoordinates/heading}} attribute to a heading, in
12111344
degrees, or `null` if the implementation cannot provide heading
12121345
information. If the hosting device is stationary (i.e., the value
12131346
of the {{GeolocationCoordinates/speed}} attribute is 0), then
12141347
initialize the {{GeolocationCoordinates/heading}} to `NaN`.
1215-
</li>
1348+
</li-->
12161349
</ol>
12171350
</li>
12181351
<li>Return a newly created {{GeolocationPosition}} instance with its

0 commit comments

Comments
 (0)