Improve markdown doc

Signed-off-by: Dmitriy Zaporozhets <dmitriy.zaporozhets@gmail.com>