Publish shared components storybook

[florianduros]

Publish shared components storybook on cloudflare
https://github.com/element-hq/sre-internal/issues/3533

[t3chguy]

IMO the environment should be Cloudflare Pages given the creds aren't scoped to a single site AIUI, for easier re-use for other CFP sites

[guillaumevillemont]

Florian asked me about it so I'll answer.
Tokens for Pages are indeed not scoped to one deployment on Cloudflare, but I still believe it's better to separate usage instead of reusing the same token for too many Pages. I try to keep token name on CF side explicit, so we can easily rotate/invalidate the correct token.
Unless it's harder to manage on the long-run for you, I'd rather keep it like that. That's also what we did for EW deployment.

[t3chguy]

Could we not embed the docs within storybook? Using something like this https://storybook.js.org/addons/@ts2doc/storybook-addon or just a link + putting _docs in a subdirectory of the built storybook, feels nuts to have 2 sites pushing on the same trigger to different places when they are related

[florianduros]

Embedded in the storybook stories is not enough because the package also exposed some functions or class (like all the i18n stuff). I'll take a look at putting it in a subdir.

[t3chguy]

Yes, that is what the thing I linked is for @florianduros - the example used is of a doc for a Typescript interface being shown in storybook - or a technique like https://stackoverflow.com/a/76614474

[florianduros]

Indeed it seems great