Docusaurs: Add index page to sample-scripts

[Jwaegebaert]

Our current docs have a useful feature on the index page for script samples where all available tags are displayed for easy searching. We should include this feature in the Docusaurus version as well.

On Docusaurus, there is a separate page that leads to all available tags on the site. It would be great if we could show these on the index page for easy reference. The link to the separate tags page is: https://jwaegebaert.github.io/cli-microsoft365-docusaurus/tags/

Let's work on adding this feature to improve user experience and make it easier to find relevant script samples.

Note!

When making a PR for this issue, make sure you target the branch docs-migration.

---

Related to #4396

[Jwaegebaert]

I did some research and it's not currently easy to implement.

There's no API available that we can use to retrieve all the tag data for our documents. However, there is a page called /tags that lists all the tags, and we can extract it using swizzle to get the DocTagsListPage component. We can customize it to make it look like our sample landing page, but in my opinion, this isn't a clean approach and may break when Docusaurus updates. Plus, we won't be able to add that page to the sidebar menu.

Therefore, I suggest we keep this issue open as it would be a nice feature to implement in the future, but it's not currently possible with Docusaurus.

[milanholemans]

Is it possible that we create our own react component that reads out all sample files? Then we could read the front matter tags and render our own overview. Not sure if this is possible.

Or we could do a quick fix and add an URL to the tags page instead of the overview.

[Jwaegebaert]

As mentioned, I couldn't find an API that allows me to read all the front matter tags. If that was possible then we could build the tags list from scratch 😄

Or we could do a quick fix and add an URL to the tags page instead of the overview.

Not quite sure how you would do this

[milanholemans]

Not quite sure how you would do this

# Script samples

Be sure to check our [script samples overview](https://pnpgithuburl.com/cli-microsoft365/tags)

Easy fix 😄

[Jwaegebaert]

Ow, like that. That's perfectly fine for me 😄