diff --git a/entity/Org_entity/Org_entity.aod b/entity/Org_entity/Org_entity.aod
index d56039b2ba6f4dcef549e9ccff54e4945e7ffd6e..06e172f4e41717f4dd6e6c5179d2edb24bfe3d9e 100644
--- a/entity/Org_entity/Org_entity.aod
+++ b/entity/Org_entity/Org_entity.aod
@@ -3,6 +3,7 @@
   <name>Org_entity</name>
   <title>Company</title>
   <majorModelMode>DISTRIBUTED</majorModelMode>
+  <documentation>%aditoprj%/entity/Org_entity/documentation.adoc</documentation>
   <iconId>VAADIN:BUILDING</iconId>
   <imageProcess>%aditoprj%/entity/Org_entity/imageProcess.js</imageProcess>
   <titleProcess>%aditoprj%/entity/Org_entity/titleProcess.js</titleProcess>
@@ -331,6 +332,7 @@
     <entityActionField>
       <name>openEditDefaultsView</name>
       <fieldType>ACTION</fieldType>
+      <documentation>%aditoprj%/entity/Org_entity/entityfields/openeditdefaultsview/documentation.adoc</documentation>
       <title>Edit defaults</title>
       <onActionProcess>%aditoprj%/entity/Org_entity/entityfields/openeditdefaultsview/onActionProcess.js</onActionProcess>
       <iconId>NEON:WRENCH</iconId>
@@ -338,6 +340,7 @@
     <entityActionField>
       <name>newOffer</name>
       <fieldType>ACTION</fieldType>
+      <documentation>%aditoprj%/entity/Org_entity/entityfields/newoffer/documentation.adoc</documentation>
       <title>New offer</title>
       <onActionProcess>%aditoprj%/entity/Org_entity/entityfields/newoffer/onActionProcess.js</onActionProcess>
       <iconId>VAADIN:CART</iconId>
diff --git a/entity/Org_entity/documentation.adoc b/entity/Org_entity/documentation.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..4c424a2c45fbfe95df0f813889e2d13cdd8e2e4c
--- /dev/null
+++ b/entity/Org_entity/documentation.adoc
@@ -0,0 +1,6 @@
+An entity for handling organisations (companies).
+
+Besides storing the main data of a company, standard values can be set:
+
+* setting the standard postal address (field directly connected to the db record container)
+* setting standard comm enties (e.g. standard phone or standard email); this is done by performing additional actions onUpdate
diff --git a/entity/Org_entity/entityfields/newoffer/documentation.adoc b/entity/Org_entity/entityfields/newoffer/documentation.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..b699f50fce2636d6210e6a264e0ff3c78019d694
--- /dev/null
+++ b/entity/Org_entity/entityfields/newoffer/documentation.adoc
@@ -0,0 +1 @@
+Opens a new OFFER-entry with the current ORG as preset.
\ No newline at end of file
diff --git a/entity/Org_entity/entityfields/openeditdefaultsview/documentation.adoc b/entity/Org_entity/entityfields/openeditdefaultsview/documentation.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..a1972d90772d14e0badfd2f9379258fd4305e50e
--- /dev/null
+++ b/entity/Org_entity/entityfields/openeditdefaultsview/documentation.adoc
@@ -0,0 +1,2 @@
+This action opens a view where standard values can be changed for a ORG. 
+For example, this could be a standard mail-address (COMM entries) or the standard (postal) address.