Improve doc

explained below. Example added.