From 7286d0948d2344f802692f8e1ec7449c139e70b3 Mon Sep 17 00:00:00 2001 From: Christian Ledermann Date: Sun, 1 Dec 2024 20:00:59 +0000 Subject: [PATCH] add note why validate=False when parsing undocumented elements --- docs/working_with_kml.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/working_with_kml.rst b/docs/working_with_kml.rst index ebb7ef6b..b810f79f 100644 --- a/docs/working_with_kml.rst +++ b/docs/working_with_kml.rst @@ -156,8 +156,10 @@ And register the new element with the KML Document object: The CascadingStyle object is now part of the KML document and can be accessed like any other element. -When parsing the document we have to skip the validation as the ``gx:CascadingStyle`` is -not in the XSD Schema. + +.. note:: + When parsing the document we have to skip the validation by passing ``validate=False`` + to ``KML.parse`` as the ``gx:CascadingStyle`` is not in the XSD Schema. Create a new KML object and confirm that the new element is parsed correctly: