issue #9: initial commit of documentation draft