08_vision.data: create docments

[warner-benjamin]

Add docments to 08_vision.data.

See the style guide and contribution guide for more details (links will be added when created).

This requires a beginner to moderate familiarity with fastai, with the exception of Show methods which probably requires advanced familiarity. This notebook defines ImageDataLoaders and SegmentationDataLoaders.

Docments progress:

• [x] Helper functions
• [x] Show methods
• [ ] TransformBlocks for vision
• [ ] ImageDataLoaders & SegmentationDataLoaders

[ChrisRichardMiles]

I am going to try to do the just the Helper functions to start out, and submit a pull request with just that. Please let me know if this is not a good thing to do

[ChrisRichardMiles]

I put in pull request 69, which documents just the helpers and also subplots in toch_core

[ChrisRichardMiles]

I am going to try to document show methods now. Actually, upon inspection, I find some problems I need some help with before I do anything more on show methods: 1) The header is a "fake header", "## Show methods-" so it doesn't show in the docs.

• Should I make it show in the docs 2) Both of the functions in this section are type-dispatched show_batch functions. They also do not show up in the docs. From some experimentation, I concluded that any function with the @typedispatch decorator does not show up in the docs. I could not find out why.
  • Is this the desired behavior? does that mean that I should not document these functions? Or I could work put a cell with show_doc(show_batch[TensorImage, TensorImage]), which will show the documentation.

[ChrisRichardMiles]

I'm going to try the TransformBlocks section now.

[cyu60]

Can I tackle ImageDataLoader and SegmentationDataLoader?

[ChrisRichardMiles]

Can I tackle ImageDataLoader and SegmentationDataLoader?

I say yes absolutely.

[cyu60]

Awesome! Thanks a lot!