rewrite the module docstring

[johnnychen94]

I deliberately separate this into a new PR so we don't get lost in the lengthy discussions in #971

closes #982

[codecov]

Codecov Report

Merging #985 (ee81136) into jc/houseclean (972d810) will not change coverage.
The diff coverage is n/a.

@@              Coverage Diff               @@
##           jc/houseclean     #985   +/-   ##
==============================================
  Coverage          87.72%   87.72%           
==============================================
  Files                  8        8           
  Lines                823      823           
==============================================
  Hits                 722      722           
  Misses               101      101           

Impacted Files	Coverage Δ
src/Images.jl	100.00% <ø> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 972d810...ee81136. Read the comment docs.

[timholy]

If we're removing the API summary, perhaps we should make sure that all listed @reexported modules have their own module docstrings. Otherwise there is some loss to this. But I think we could merge this and then fix those.

[johnnychen94]

But I think we could merge this and then fix those.

This seems to be a 1.0 milestone. I plan to have an issue to track all the exported symbols and add necessary docstrings and demo page before 1.0 release. (#986)

[timholy]

Suggested change

	The purpose of this package is to have an out-of-box experiences for most of the stable
	functionalities. This means when you do `using Images`, you load a lot of packages that
	Images provides an out-of-box toolkit for image processing.
	This means when you do `using Images`, you load a lot of packages that

[johnnychen94]

for most of the stable functionalities.

I do have some concerns with this. I'll write up a new issue to explain it.

[johnnychen94]

See simonster/Reexport.jl#37. This is why I think we can't expect Images to provide up-to-date functionalities if we want to follow the semver strictly. We have abused it a lot but I think we need to be more cautious on this after v1.0