new documentation
mardown fixes
minor updates, annotations

some new annotations
beginning of coding the value conversion (only in comment block)
cleaning the code
added