Add hook example to access metadata

[noklam]

NOTE: Kedro datasets are moving from kedro.extras.datasets to a separate kedro-datasets package in
kedro-plugins repository. Any changes to the dataset implementations
should be done by opening a pull request in that repository.

Description

fix #2676

Development notes

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
• Checked if this change will affect Kedro-Viz, and if so, communicated that with the Viz team

[noklam]

I will keep the PR simple and I created the follow up in #2999

[astrojuanlu]

All these parameters are not used right? Maybe we can remove them from the function. Pluggy allows this

[noklam]

Fair point. We do this inconsistently, sometimes we do include signature that wasn't used (I was asked to add that before, can't find it exactly which PR it is).

For example, after_node_run has a redundant node argument.
https://docs.kedro.org/en/stable/hooks/examples.html#add-observability-to-your-pipeline

[noklam]

@stichbury do you think we should keep all our example minimals? We can do a clean up if this is agreed.

In this case

   def after_catalog_created(
        self,
        catalog: DataCatalog,
        conf_catalog: Dict[str, Any],
        conf_creds: Dict[str, Any],
        feed_dict: Dict[str, Any],
        save_version: str,
        load_versions: Dict[str, str])

or

   def after_catalog_created(
        self,
        catalog: DataCatalog)

will both work.

[stichbury]

I think it's fine to remove them too and keep it minimal.

[stichbury]

Suggested change

	## Use Hook to read `metadata` from `DataCatalog`
	## Use a Hook to read `metadata` from `DataCatalog`

[stichbury]

Suggested change

	We recommend to use the `after_catalog_created` hook if you need to access `metadata` to extend Kedro.
	Use the `after_catalog_created` Hook to access `metadata` to extend Kedro.

[stichbury]

Approved with minor changes. What's Vale saying about this page?

[astrojuanlu]

I like this example 👍🏽 but I'm wondering, is this a full solution for #2676? Wondering if we should have some prose somewhere else in the data catalog documentation, otherwise I fear it might be a bit difficult to find. Essentially what @stichbury wrote in #2940 as a response to the reviews on #2888.

What do you think?

[noklam]

@astrojuanlu Maybe we split the ticket too much, that should be kedro-org/kedro-viz#1650 ?

[astrojuanlu]

Too many tickets 🥲 Thanks @noklam !