documentation on deprecating Integer type in favor of Normed

[johnnychen94]

In JuliaImages images are stored using the following three datatypes:

• FixedPointNumbers.Normed, e.g., N0f8, N0f16
• AbstractFloat, e.g., Float32, Float64
• Bool

⚠️ We don't represent images as array of Integer (except Bool)

We also need some documentation explaining the wrap around behavior of N0f8

related issues:

JuliaImages/ImageCore.jl#76 (comment)
JuliaImages/ImageCore.jl#72
JuliaMath/FixedPointNumbers.jl#41

[timholy]

We already have quite a lot of documentation on this:

• https://juliaimages.org/latest/arrays_colors/#fixedpoint-1
• https://juliaimages.org/latest/arrays_colors/#A-note-on-arithmetic-overflow-1

What's the specific proposal?

[johnnychen94]

Folks around me say the documentation is hard to read and understand. The first time I read the documentation in Aug 2018, I felt the same.
I'm planning to reorganize the current materials of JuliaImages documentation at some time point, this issue serves as a memo.

[timholy]

I worry about that too. It will definitely help if other people work on it, it's always a bit dangerous when the person who writes the code also writes the documentation.