DOC: documented that .apply(func) executes func twice the first time

Related issues are #2656, #2936 and #6753.