[MRG] DOC Refactor example to remove ambiguity in understanding param order

Fixes #3267