Address validation explanation

neonContext/Address/Address.aod

@@ -3,6 +3,7 @@
   <name>Address</name>
   <title>Addresses</title>
   <majorModelMode>DISTRIBUTED</majorModelMode>
+  <documentation>%aditoprj%/neonContext/Address/documentation.adoc</documentation>
   <lookupView>AddressLookup_view</lookupView>
   <entity>Address_entity</entity>
   <references>

neonContext/Address/documentation.adoc

+The address Entity provides addresses for contacts.
+
+If you need address completion / validation support, see documentatioin of AddressValidation Context.
\ No newline at end of file

neonContext/AddressValidation/AddressValidation.aod

@@ -2,6 +2,7 @@
 <neonContext xmlns="http://www.adito.de/2018/ao/Model" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" VERSION="1.1.1" xsi:schemaLocation="http://www.adito.de/2018/ao/Model adito://models/xsd/neonContext/1.1.1">
   <name>AddressValidation</name>
   <majorModelMode>DISTRIBUTED</majorModelMode>
+  <documentation>%aditoprj%/neonContext/AddressValidation/documentation.adoc</documentation>
   <lookupView>AddressValidationLookup_view</lookupView>
   <entity>AddressValidation_entity</entity>
   <references>

neonContext/AddressValidation/documentation.adoc

+The AddressValidation Context provides a way to load a list of valid addresses by using a custom datasource (e.g. a webservice) based on the user input.
+
+To enable the address-lookups for the address-entity, go to 
+preferences -> _____PREFERENCES_PROJECT -> _____PREFERENCES_PROJECT (in the navigator) -> and enable the checkbox "nominatim.enable"
+
+There are the following configurations are possible to control the nominatim-server, which is used in xrmBasic:
+"nominatim.enable"
+"nominatim.url"
+"nominatim.user"
+"nominatim.pw"
+
+If you would like to use a different webservice (or other datasource are also possible), you can extend the WsValidation_lib.
+See the documentation inside of the lib.
+Basically you just have to add a new type and the respective callbacks.
+