--- robots: noindex, nofollow tags: pitch --- # Versioned docsite for react-northstar ### Problem *"Hey, this does not work as documented!" "Sure, that changed two months ago!"* - teams uses react-northstar 0.47 - latest version is 0.51 (four versions ahead) - the version docs are available for Application developers do not have access to the documentation of the version they use. Library developers do not want to release a new version of the library not to break the documentation. The current URL for the docsite is https://fluentsite.z22.web.core.windows.net/ - that does not look like an official URL for Microsoft library. ### Appetite Support side by side deployments of multiple docsite versions. ### Solution Define versions granurality (do we want to keep every major.minor.patch or major.minor or just major). Make sure links to individual examples work after new docsite version is deployed (points to latest or permalink?). Think about cleanup strategy - do we remove old versions automatically? Move docsite to a more trusworthy domain. ### Risks (Rabbit holes) We will not agree on the domain name. v7 branch and repo/CI rework can collide with these changes. ### Out of scope (No-gos) UI Builder moved out of docsite (and allows to use different versions of react-northstar).