enhance documentation

cleder · Nov 30, 2024 · c58c8da · c58c8da
1 parent a0f5851
commit c58c8da
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 6 deletions.
diff --git a/docs/index.rst b/docs/index.rst
@@ -29,5 +29,6 @@ requirements, namely:
    upgrading
    fastkml
    contributing
+   kml
    alternatives
    HISTORY
diff --git a/docs/kml.rst b/docs/kml.rst
@@ -1,9 +1,13 @@
 KML Resources and Tutorials
 ===========================
 
+Learning KML can be straightforward with the right resources.
+Here are some of the best sources:
 
-https://developers.google.com/kml
 
-https://en.wikipedia.org/wiki/Keyhole_Markup_Language
+`Google Developers - KML  <https://developers.google.com/kml>`_ provides a comprehensive
+guide to KML, including tutorials, reference, and examples.
 
-https://support.safe.com/hc/en-us/sections/25407358419469-OGC-Google-KML
+
+The `FME Support Center's section on OGC and Google KML <https://support.safe.com/hc/en-us/sections/25407358419469-OGC-Google-KML>`_
+provides detailed guidance for creating, styling, and optimizing KML files.
diff --git a/docs/working_with_kml.rst b/docs/working_with_kml.rst
@@ -50,8 +50,12 @@ We could also search for all Points, which will also return the Points inside th
 
 ``find_all`` can also search for arbitrary elements by their attributes, by passing the
 attribute name and value as keyword arguments.
-``find`` is a shortcut for ``find_all`` that returns the first element found, which is
-useful when we know there is only one element that matches the search criteria.
+
+.. note::
+
+    ``find`` is a shortcut for ``find_all`` that returns the first element found,
+    which is useful when we know there is only one element that matches the search
+    criteria.
 
 .. code-block:: pycon
 
@@ -232,7 +236,7 @@ Now we can remove the CascadingStyle from the document and have a look at the re
           <kml:displayMode>hide</kml:displayMode>
         </kml:BalloonStyle>
       </kml:Style>
-      <kml:Placemark id="04AFE6060F147CE66FBD">
+      <kml:Placemark id="04SAFE6060F147CE66FBD">
         <kml:name>Ort1</kml:name>
         <kml:LookAt>
           <kml:longitude>10.06256752902339</kml:longitude>