[DOC] fix description and add Remark
[DOC] typos, grammar
Merge pull request #459 from h-2/dox/align_extend

[DOC] fix description and add Remark