Open zjp-CN opened 3 weeks ago
一般构建依赖库的文档,在开发时是最有用的。
但 os-checker 作为一个集成工具,显示太多的依赖库文档是不必要的?因为 os-checker 部署文档的主要使用者是库的使用者而不是库的开发者。(开发者可以使用本地构建来浏览依赖项的 APIs)
而且,当前仅在 os-checker 和 test-suite 上构建含依赖的文档,就需要 41.5 MB 存储大小的静态网页。(Github Pages 有 1 GB 的部署上限。)
更新:当应用 --no-deps 时,文档大小为 4.17 MB,缩小了 10 倍。并且侧边栏看起来更清爽:
--no-deps
一般构建依赖库的文档,在开发时是最有用的。
但 os-checker 作为一个集成工具,显示太多的依赖库文档是不必要的?因为 os-checker 部署文档的主要使用者是库的使用者而不是库的开发者。(开发者可以使用本地构建来浏览依赖项的 APIs)
而且,当前仅在 os-checker 和 test-suite 上构建含依赖的文档,就需要 41.5 MB 存储大小的静态网页。(Github Pages 有 1 GB 的部署上限。)
更新:当应用
--no-deps
时,文档大小为 4.17 MB,缩小了 10 倍。并且侧边栏看起来更清爽: