update documentation for #344, #362 and #367
update changes history
fix styling...
fix styling...