[doc] add information on shitty behavior