diff --git a/others/guide/how to write JDito code.adoc b/others/guide/how to write JDito code.adoc
index 7e71a092f62e6fdd0ee34c4c77d5e6be4ee5c6eb..79d6a489bccec838c897e390e6607cdb895c69b3 100644
--- a/others/guide/how to write JDito code.adoc	
+++ b/others/guide/how to write JDito code.adoc	
@@ -1,5 +1,5 @@
 How to write JDito code
-============================
+=======================
 :toc2: left
 :numbered:
 
@@ -26,11 +26,27 @@ data = vars.get.......
 Example:
 [source,javascript]
 ----
-for (i = 0, i < dataLen; i++){
+for (i = 0, i < dataLen; i++) {
     //code here
 }
 ----
 
+=== loops ===
+nested loops should be defined with replicated indexer variables (or with a good and describing name)
+
+Therefore it's easy to see in which level of the counter you are.
+
+Example:
+[source,javascript]
+----
+for (i = 0, i < dataLen; i++) {
+    for (ii = 0, ii < dataLen[i].length; ii++) {
+        //code...
+    }
+}
+----
+
+
 == defining different types of functions n libraries ==
 
 === by using static methods ===
diff --git a/others/guide/how to write a library.adoc b/others/guide/how to write a library.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..a3175cc3f706693f1bcf5664c997e095dd5362f4
--- /dev/null
+++ b/others/guide/how to write a library.adoc	
@@ -0,0 +1,110 @@
+How to write a JDito library
+============================
+:toc2: left
+:numbered:
+
+
+== defining different types of functions ==
+
+=== by using static methods ===
+This will be mostly utility functions and so on, where there is no need to instanciate an object. You'll need this probably the most time.
+
+
+Definition:
+[source,javascript]
+----
+/**
+ * provides static methods for validation of communication data
+ * do not create an instance of this
+ * @static
+ * @class
+ */
+function CommValidationUtil(){<1>
+}
+
+/**
+ * returns a blueprint for validation extensions; these extensions are needed for validating comm data and can be passed to other functions
+ * @return {object} a object with properties that have a specific default value; normally you want to overwrite that value
+ */
+CommValidationUtil.getExtensionsBlueprint = function(){<2>
+    return {
+        countryCode: null
+    };
+}
+----
+<1> the function-object that keeps everything together - this function should never be actually called (no direct call, no indirect call)
+<2> an actual function that can be called
+
+And how to use it:
+[source,javascript]
+----
+import("Comm_lib");
+
+var additionals = CommValidationUtil.getExtensionsBlueprint();
+----
+
+=== by creating an object with functions ===
+
+You may want to hold data and create objects where methods share that data. 
+
+Definition:
+[source,javascript]
+----
+/**
+ * object for easier handling of conditions; <1>
+ * With this object you do not have to check if the string is empty or not;
+ * you don't need to append a "1=1" condition or similar;
+ * this objects gains most benefit if you have a lot of conditions that are added (or not) depending on tons of JDito-conditions
+ * @class 
+ * @param {String} [alias=the current alias] the database alias where the condition shall be executed later (important for column types of preparedStatements) <2>
+ * @example //TODO: add missing example <3>
+ */
+function SqlCondition(alias){<4>
+   //setting null is only needed to provide autocomplete for the ADITO-designer
+    this.preparedValues = null;
+    this._init();//the properties are initalized in an extra function because init is nearly the same as resetting (clearing) the SqlConditions
+    this.alias = alias;
+}
+/**
+ * append with SQL-and; no paranthesize of existing conditions is done
+ * @param {String} cond the condition string which shall be appended
+ * @return {Object} current SqlCondition-object
+ */
+SqlCondition.prototype.and = function(cond){<5>
+    if (!cond)
+        return this;
+    if (this._sqlStorage)
+        this._sqlStorage += " and ";
+    this._sqlStorage += cond;
+    return this;
+}
+----
+
+<1> JS-Doc comment: http://usejsdoc.org/
+<2> use the correct form for optional/required parameters: http://usejsdoc.org/tags-param.html
+<3> examples are usefull on more complex functions
+<4> constructor function; init propiertes (do not set functions ("methods") here!)
+<5> add functions ("methods") to the prototype, they are available through the prototype chain
+
+And how to use it (normally you'd want to use preparedStatements but for the sake of an easy example it's a bit shorter here)
+[source,javascript]
+----
+import("system.vars");
+import("system.result");
+import("Sql_lib");
+import("Comm_lib");
+
+var cond, mediumIds, idVal;
+
+cond = new SqlCondition();
+
+mediumIds = CommExtensions.getContextualMediumIds();
+if (mediumIds.length > 0)
+    cond.and("COMM.MEDIUM_ID in (" + mediumIds.join(", ") + ")");
+
+idVal = vars.get("$local.idvalue");
+if (uids.length > 0)
+    cond.and("COMM.COMMID = '" + idVal + "' ");
+
+result.string(cond.toString("COMM.OPTIONAL = 't'"));
+----
\ No newline at end of file