ENH micro-optimize gradient boosting
DOC: Explain prediction when decision_function is zero

LogisticRegression and liblinear's predictions differ when the
decision function is zero. Explain why and what to do in that case.

Fixes #3600 (by documenting the won't fix status).