Add tools documentation page

[AhdraMeraliQB]

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

Populate the page new_project_tools.md with information on the new tools (formerly known as add-ons).

BLOCKERS:

• Iterate on feedback on Project Creation Flow  #3054
• Make it possible to create project from config without providing add_ons or example_pipeline #3342
• Do we still need to remove conf.py and index.rst following build-docs removal  #3376

To-Do:

• Add images to placeholders

Development notes

Developer Certificate of Origin

We need all contributions to comply with the Developer Certificate of Origin (DCO). All commits must be signed off by including a Signed-off-by line in the commit message. See our wiki for guidance.

If your PR is blocked due to unsigned commits, then you must follow the instructions under "Rebase the branch" on the GitHub Checks page for your PR. This will retroactively add the sign-off to all unsigned commits and allow the DCO check to pass.

Checklist

• Read the contributing guidelines
• Signed off each commit with a Developer Certificate of Origin (DCO)
• 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

[merelcht]

Some final minor comments from my side, but other than that this looks good to go! 👏 Amazing work @AhdraMeraliQB and @SajidAlamQB 🥳

[amandakys]

I'm sorry if this is not a very useful to provide doc's feedback 😅 I had the following thoughts:

• Is it normal to show the CLI as images rather than code snippets, the images are weirdly scaled compared to the rest of the content
• when we refer to kedro new --help would it be possible to just show the tools related help text? this would be more relevant we could put ... before and after to indicate it's a snippet.
  
• when we use commands as titles i feel it is unclear for example
  
  To me it just seems like the code snippet is strangely large compared to the others. and it's not immediately clear that its a section header. Perhaps we could change to include some normal text too? For example Specify tools configuration using `kedro new --config=
• for this line in Kedro tools would it be possible to add the in page linking, since we have it set up already from the nav bar. The available tools include: linting, testing, custom logging, documentation, data structure, PySpark, and Kedro-Viz.
  

[amandakys]

LGTM

[amandakys]

oh whoops i noticed this

when i click the custom logging short link it does this to the page (with the large whitespace), its not there at first

[AhdraMeraliQB]

@amandakys

https://kedro--3331.org.readthedocs.build/en/3331/starters/new_project_tools.html

Just tested - all in-page links do that, perhaps so the navigation is easier to notice? I think it's a Sphinx/markdown quirk

Edit: Same thing happens on pre-existing https://kedro--3331.org.readthedocs.build/en/3331/configuration/advanced_configuration.html#how-to-use-a-custom-configuration-loader so I'll exclude this from this PR context

[noklam]

https://kedro--3331.org.readthedocs.build/en/3331/starters/index.html

The content looks good to me. One question from me is that I found the order of the docs strange. We mentioned kedro new --config very early but this is rarely used, do we need to included this in the index page?

[AhdraMeraliQB]

@noklam

https://kedro--3331.org.readthedocs.build/en/3331/starters/index.html

The content looks good to me. One question from me is that I found the order of the docs strange. We mentioned kedro new --config very early but this is rarely used, do we need to included this in the index page?

We didn't want to rule out seeing a spike in kedro new --config with the additional prompts to the project creation flow. Additionally if there was a discovery problem, this should help 😄