[DOC] Added documentation and tests for mean_pool function

Addresses #1141 

I can add more if needed - I found that once I used it a little the existing documentation was pretty good. Added an example and a test to be more complete, as well as clarifying the ```image_shape``` parameter .