Update the FlatList Component in Lists

[ayushjainrksh]

Fixes #32

Summary

• Update the title, prop descriptions and method descriptions from docs.
• Add SnackPlayer examples with example annotation.
• Add inherits annotation for the inherited link.
• Remove unnecessary asterisks in comments.

[ayushjainrksh]

Problem

The documentation contains some props that are not defined in the code.

Example

A few examples would be:

Possible Solution

• These props can be added in the flow type with documentation in the comments(just like all other props).

[jevakallio]

One comment to improve the faded edge docs, but otherwise LGTM!

[jevakallio]

Problem

The documentation contains some props that are not defined in the code.

Example

A few examples would be:

Possible Solution

• These props can be added in the flow type with documentation in the comments(just like all other props).

@ayushjainrksh these component props are defined on the underlying VirtualizedList. The documentation for FlatList states "This is a convenience wrapper around , and thus inherits its props (as well as those of ) that aren't explicitly listed here".

I would read this to mean that these props should not be documented here. From the point of view of the documentation reader it might be useful to have better indication in the docs what props are being inherited from other components, so that the developer knows they can be passed to this component.

I think best way forward is to remove these for now, and create a new issue for improving inherited prop visibility overall. Thoughts @motiz88?