[doc] update documentation
[doc] link to clarify