Why arent old versions of the documentation visible with a subdomain?
還沒有人認領這個 Issue。
- 主要語言
- JavaScript
- 星號
- 11.8k
- 分支
- 7.9k
- 平均合併
- 1 天 11 小時
- 30 天內合併 PR
- 11
描述
React maintainers could simply generate the old HTML and cut subdomains of how the site used to look on older versions with older examples and api specifications.
Then link and archive them on the current site where it brings people into the subdomain to view all the documentation.
You could throw a warning on each HTML document that says you are looking at old documentation and it brings you to the main website.
MUI does this just fine for old versions:
Why have the react maintainers gotten away from it for so long? You guys dont even have branches and tags of what the documentation looked like at the time of a particular relase, so I guess people have to go back in main history (find the date or commit title on the release they are looking for) and run yarn dev on this repo to see how the site looked back then? Is that the approach?
Minimally even if you do not implement subdomains on the primary domain, we should go through and create tags against the date which each release was done and people can easily check out the tag revision and run the site locally if it is not in the best interest of the react community to do the subdomain approach.
As a hack then if we do not implement subdomain documentation, you could say on the main site "Looking for older documentation? git checkout a tag and run the site locally" as a hack/workaround.
But with this being such a huge library I would have thought this would be like MUI's documentation.
Maybe I am missing something here and am completely out of line.
Let me know! Thanks for all the hard work regardless. React has changed my front-end life 8 years ago when I started using it. My have times changed since createClass() LOL.
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
檢視 react.dev 儲存庫的發行歷史和現有的 yarn dev 工作流程,以了解如何識別和檢視舊版文件。比較所提出的子網域、發行標籤和本機檢出方案,然後定義一種受支援的方式,讓使用者存取版本化文件,並提供明確的警告或連結返回目前的網站。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- javascript, react
- 領域
- documentation
- Issue 類型
- 功能
- 難度
- 5/5
- 預估耗時
- 一週以上
- 活躍度
- 停滯
- 描述清晰度
- 需要釐清
- 新手友好度
- 25/100