make popups more predictable

Related to https://github.com/ArcBees/GWTP/issues/554
Then you should put back this piece of documentation. It's still relevant