fix: docs error toLowerCase

[edoardolincetto]

Fixes #751

PR Checklist

• My branch is up-to-date with the Upstream master branch.
• The unit tests pass locally with my changes (if applicable).
• I have added tests that prove my fix is effective or that my feature works (if applicable).
• I have added necessary documentation (if appropriate).

Short description of what this resolves:

Not passing the story prop causes the following error: Cannot read properties of null (reading 'toLowerCase'); passing some illegal characters to the LinkTo component (@storybook/addon-link) breaks the link;

Changes proposed in this Pull Request:

• In the MDX files, replace (where possibile) LinkTo with the standard Markdown syntax to create links to other stories, documentation pages and sections.
• Where LinkTo is needed, add the story prop and remove illegal characters.

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/dip-trasformazione-digitale/design-react-kit/CMWUUUyZwyHHZbBxLcWLbm25kprG
✅ Preview: https://design-react-kit-git-fork-ed-46c8b4-dip-trasformazione-digitale.vercel.app

[dej611]

Do you have any source about the problem? Having a list of the "illegal" characters would be useful.
Also, what about linkTo function? Is that affected of the same problem?

[edoardolincetto]

We need to link specific anchors of other stories, but unfortunately, doing that shows two issues:

1. Without a story prop (passed to LinkTo), the toLowerCase error is thrown in the console.
   Addons-links with MDX storybookjs/storybook#10846
2. Adding the story prop and, at the same time, linking to a specific anchor using the path query string breaks the link (because Storybook sanitizes strings replacing the # character with a -).
   Here's the full list of characters that Storybook replaces with a -.

Anyway, I've replaced the LinkTo (with the standard Markdown link syntax) only in the Markdown lines, not the JSX ones. I think this makes the docs cleaner than using the linkTo function.
That's how, in my opinion, it should be:

• Use the standard Markdown link syntax in the Markdown parts of the code;
• Use the LinkTo component in the JSX parts of the code.

[dej611]

Great job 👍 and thanks for all the info 🎉 : now they are documented in case of further investigations.