Hi Mustafa,
Thanks for your interest in providing documentation for your plugin, and for highlighting that the guide Plugin documentation is not so clear.
I have just rewritten the first section 'Where should the documentation go?' to hopefully make it clearer. Please let us know if you have any further questions.