Home.md

@@ -217,6 +217,8 @@ WHERE {
 
 ####     4\.4 UN observers:
 
+The following query retrieves the 2 UN observers and their english preferred labels.
+
 ```plaintext
 PREFIX owl: <http://www.w3.org/2002/07/owl#>
 PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
@@ -256,6 +258,8 @@ SELECT distinct ?country_uri ?named_authority_code ?country_en  WHERE {
 
 ####     4\.5 Disputed territories:
 
+The following query retrieves the territories or marine areas disputed by different countries.
+
 ```plaintext
 PREFIX owl: <http://www.w3.org/2002/07/owl#>
 PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
@@ -265,18 +269,22 @@ PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
 PREFIX dct: <http://purl.org/dc/terms/>
 
 SELECT distinct ?country_uri ?named_authority_code ?country_en  WHERE {
-    values ?scheme {
-     <http://publications.europa.eu/resource/authority/country/0004>
-    }
+   
+    # Retrieving the countries and their english preferred labels
     ?country_uri a skos:Concept .
     ?country_uri skos:prefLabel ?c_en .
-    Bind(str(?c_en) as ?country_en)
-    ?country_uri skos:inScheme ?scheme .
     filter(lang(?c_en) = "en") 
+    Bind(str(?c_en) as ?country_en)
+   
+    # Filtering only the territories and marine areas link to the scheme "Disputed territories"
+    ?country_uri skos:inScheme  <http://publications.europa.eu/resource/authority/country/0004> .
+
+    # Filtering out the deprecated and the retired concepts
     filter not exists {?country_uri owl:deprecated ?true}
     filter not exists {
-    ?country_uri euvoc:status <http://publications.europa.eu/resource/authority/concept-status/RETIRED>
-    }
+    ?country_uri euvoc:status <http://publications.europa.eu/resource/authority/concept-status/RETIRED>}
+
+    # Retrieval of the EU official code
     ?country_uri euvoc:xlNotation ?not_authority .
     ?not_authority rdf:value ?named_authority_code .
     ?not_authority dct:type <http://publications.europa.eu/resource/authority/notation-type/NAC> .