Improve DataSet API documentation with YAML examples

[levimjoseph]

Description

Adding YAML documentation
In response to: #1762

Development notes

I changed the following files:

• kedro/extras/datasets/api
• kedro/extras/datasets/dask
• kedro/extras/datasets/pandas
• kedro/extras/datasets/tensorflow
• kedro/extras/datasets/tracking
• kedro/extras/datasets/tracking
• kedro/extras/datasets/yaml

I ran the test suite.

Checklist

• Read the contributing guidelines
• Opened this PR as a 'Draft Pull Request' if it is work-in-progress
• Updated the documentation to reflect the code changes
• Added a description of this change in the RELEASE.md file
• Added tests to cover my changes

[levimjoseph]

@noklam this is my draft pr. First PR, so any advice/input is welcome

[noklam]

Thanks @levimjoseph for the PR and sorry for the really late review.

Just to check if you have run some of the code to check if the YAML API works?

I notice there are some inconsistencies (some of them are inherit from our docs). In general, the Python API and YAML API are the describing the same dataset, which I like because it demonstrate how to map these arguments clearly.

In some cases the original example are too simple, so I think it's fine even if the new YAML API are not exactly the same.

There are way too many s3, gcs paths that are too complicated as an exampe, but we will address this later. For API docs I think it's nice to have at least 1 example that is easy to copy & paste without too many setups.

[merelcht]

Thanks for taking this on @levimjoseph 👍 I've left some comments.

[merelcht]

Hi @levimjoseph , do you need some help finishing this PR?

[merelcht]

Hi @levimjoseph do you still want to complete this PR, or should someone from the team take-over? We'd like to get all PRs related to datasets to be merged soon now we're moving our datasets code to a different package (see our medium blog post for more details)

[noklam]

Looks good ⭐️ Thank you @levimjoseph and @merelcht