Provide basic documentation for skimage subpackages

[DavidBreuer]

Description

Following the discussion in #2762, I provide a basic documentation for all skimage subpackages.

Checklist

• Clean style in the spirit of PEP8
• Docstrings for all functions
• (does not apply) Gallery example in ./doc/examples (new features only)
• (does not apply) Unit tests

References

Not related to any issue but see discussion in #2762.

For reviewers

(Don't remove the checklist below.)

• Check that the PR title is short, concise, and will make sense 1 year
  later.
• Check that new functions are imported in corresponding __init__.py.
• Check that new features, API changes, and deprecations are mentioned in
  doc/release/release_dev.rst.

[pep8speaks]

Hello @DavidBreuer! Thanks for updating the PR.

Cheers ! There are no PEP8 issues in this Pull Request. 🍻

Comment last updated on May 01, 2018 at 12:59 Hours UTC

[soupault]

See also https://github.com/scikit-image/scikit-image/blob/master/skimage/__init__.py .

[emmanuelle]

Thank you very much for these explanations. They will also appear in the API page on the online documentation (http://scikit-image.org/docs/stable/api/api.html) so we have to make sure that it's not too long. I would juste remove the part on filters.rank.

[emmanuelle]

This part will not be rendered well in the API page of the documentation (http://scikit-image.org/docs/stable/api/api.html)

[jni]

@emmanuelle can you elaborate on why?

[sciunto]

@emmanuelle Would you like to have a look at this PR and try eventually to make it good for a merge?