monorepo 中的文檔版本控制

Question

背景：我有一個包含多個子目錄的倉庫。 例如

Myrepo:
 Foo
  Readme.md
  Changelog.md
 Bar
  Readme.md
  Changelog.md

每個子目錄在 Github 中都有自己的版本標簽。 例如 Foo v1.0.0 Bar v2.0.0

我目前正在為我開始使用 Mkdocs 研究的每個子目錄探索一個單獨的版本控制文檔，並將該文檔托管在 Github Pages 中。 雖然我可以使用 mike 進行版本控制和 monorepo 插件將所有文檔合並到一個地方，但此選項只能為 repo 創建一個全局文檔版本，而不是為每個子目錄創建單獨的文檔版本。 所以我會在 Github Page 有這樣的東西

MyRepo Document V1
 Foo
 Bar

MyRepo Document V2
 Foo
 Bar

代替

MyRepo Document V1, V2
 Foo V1, V2
 Bar V1, V2

我只是想知道是否有人遇到過這個問題，以及在 monorepo 場景中單個文檔版本控制的最佳選擇是什么。 或者這是否不可能？

謝謝

Answer 1

理想情況下，版本號不會出現在文件或文件夾名稱中：這將破壞所有“版本控制”方面。

您將使用：

• 一個分支 V1 或 V2，您可以在其中擁有 V1 或 V2 的文檔版本
• 標記 V1 或 V2 以標記 V1 或 V2 的最終狀態。

這樣，由於文檔保持相同的路徑和文件名，您可以在分支之間合並或輕松進行差異。