[Feature]: docs metadata configuration for v9

[Hotell]

Library

React Components / v9 (@fluentui/react-components)

Describe the feature that you would like added

Current component workflow is like following:

flowchart TB


A["new package"];
B["alpha release"]
C["beta/RC release"]
D["add to react-components unstable"]
DP["stories exposed to Docs"]

subgraph one["package release stage"]
A --> B --> C;
end

C -...-> D

subgraph two["package docs exposure"]
D --> DP
end

Loading

Scenario:

• package is added to unstable/stable for react-components. We don't wanna render its stories in docsite

Proposal:

Introduce new package.json metadata field, with following API:

{
 "name": "@fluentui/new-package"
 "docs": { "enabled": false }
}

By default it will be false so the existing workflow will be a bit different. it will be package author responsibility to mark this to true once he is sure that stories can land in public docsite.

This can be automated as part of upcoming API propagation automation: nx workspace-generator add-package-to-react-components --name=@fluentui/new-package --access=unstable --docs

Have you discussed this feature with our team

v-build

Additional context

No response

Validations

• Check that there isn't already an issue that request the same feature to avoid creating a duplicate.

[msft-fluent-ui-bot]

Because this issue has not had activity for over 150 days, we're automatically closing it for house-keeping purposes.

Still require assistance? Please, create a new issue with up-to date details.

[Hotell]

we switched to new preview(unstable) packages release approach which makes this feature not needed.

on 1st preview release - package stories will be added to public-docsite automatically

closing as wont implement/superseded by #28471