update documentation about the new automated port selection behaviour