plone.api.folder added 

Implemented 

https://github.com/plone/plone.api/issues/177
Breaks the docstring style guide: http://docs.plone.org/external/plone.api/docs/contribute/conventions.html#docstrings-style