intro tutorial draft 1

[hankunxiao]

No description provided.

[hankunxiao]

The hyperlinks to the each individual function's documentation need to updated once we push our docs to readthedocs.io.

[Arc-Celt]

Great intro overall! All the examples and options to load and display images are sound and clear.
One thing I wanna ask about is that what does "Yalla" in the subtitle mean?
And consider adding more background info in the starters of the background story. Currently it seems a bit strange that after the subtitle "Sami's Story", you immediately start with "he...". You could rewrite the start to introduce Sami, for example:
"Sami is a cat meme enthusiast who is always on the lookout for the best cat memes. He also loves taking pictures of his own cats to create memes every day."

[Arc-Celt]

Also, I suggest changing the Heading I title to something else, like "First Things First", because the html rendered will list the title on the sidebar under the existing "Tutorial", and it would seem a bit repetitive.

[hankunxiao]

Great intro overall! All the examples and options to load and display images are sound and clear. One thing I wanna ask about is that what does "Yalla" in the subtitle mean? And consider adding more background info in the starters of the background story. Currently it seems a bit strange that after the subtitle "Sami's Story", you immediately start with "he...". You could rewrite the start to introduce Sami, for example: "Sami is a cat meme enthusiast who is always on the lookout for the best cat memes. He also loves taking pictures of his own cats to create memes every day."

Yalla means "Let's get started". I will update it to "Let's get started" for more clarity.
That's good suggestion. i will update them

[hankunxiao]

@Arc-Celt thanks for your feedback. I have incorporate them in the latest commit. You can go to this feature branch and find the updates.

[Arc-Celt]

Everything looks great now! Should be ok to merge

[hankunxiao]

@JennyonOort I have pushed the 2nd draft to this feature branch. Please adjust it as needed.
CC: @Arc-Celt

[JennyonOort]

Intro draft rewritten for consistency and mutually exclusivity to other individual functions.

[JennyonOort]

Here is the revised structure of intro proposed. Removed web url reading option as per discussion it is usually not stable and downloading is preferred. In addition, a default [0, 255] range image reader is selected and thus conversion becomes optional and does not need demonstration.