Proposal: Introduce react-fluentui-examples project

[george-cz]

Motivation

Historically, in the effort of supporting our partners, we've built a lot of examples in Stackblitz displaying how to use our components in a particular use case. These use cases don't usually (ever?) make it back to the original docsite, even though others could potentially benefit from them too. The reasons for this are multiple:

• these examples are not generic enough
• these examples don't demonstrate the component's props/API directly, but build on top of the component to get a closer idea how to productionalize the component
• these examples may combine multiple components
• the doc examples have to be carefully curated, straightforward and to the point of what part of the API are they demonstrating

The problem with the current approach is that these carefully crafted examples end in up /dev/null eventually because we forget about them, or don't know about their existence in the first place. Having one place where we could store these, link to them and let the user quickly run them and play with them would be benefitial.

Other attempts

The Fluent UI v0 already has a concept of this, they call it Prototypes. This means that the idea behind this concept has been validated in the past, has proven useful and we should strive to provide a similar solution for our V9 docs.

How this works

The main ideas behind this PR are:

• We have a place where we can store these more complex examples
• Github repo is easy to share and Stackblitz has support to load code directly from here (Stackblitz provides a nice button!)

Visit the project here

Other considerations

• We might want to consider tighter integration with the official doc site in the future
• Would be nice to have a script that bootstraps the example (something I can work on if this gains some traction)
• Granularity level for the examples: should the react-fluentui-examples be just one package and examples just storybook? Storybook has limitations, the current approach (each example is its own package) is similar to maintain, use in Stackblitz and provides more flexibility though.

Footnote

Before this gets merged, all of the links should be updated to target the main branch. Right now for the sake of validating the PR and the usage, it points to this PR branch.

[ling1726]

I think we should consider a way to get these examples served by the official docsite. It would be good to have a single source of truth here. One of the big issues with v0 prototypes was that they were not discoverable