generated doc after freerk editing
Merge pull request #626 from georgebyelas/master

generated doc after freerk editing
update docs, after Lennart review
Merge pull request #628 from georgebyelas/master

update docs, after Lennart review