刘易斯·考尔斯 (He/Him, They,Them,Theirs)

发表的评论

我购买了平装本并已下载。我真诚希望作者能从平装本中获得一些收入,因为我注意到价格低于 LuLu 通常的收费。

非常有趣。

我喜欢简洁、文笔好、易于维护的文档,我不认为这些文档就逊色。

我发现“世界奇观”式的努力似乎最容易腐烂。它们需要付出艰苦的努力来修订,或者有非常糟糕的搜索和浏览机制(即使内容在那里也没用,如果我必须 grep 才能找到特定的措辞,那就会有问题)。

这也不是作者的缺点。如何设计一个通过标题、标签和措辞进行一致搜索的系统,它具有易于理解的 UI,又不会像 Elasticsearch 支持的系统那样过于宽松(在我看来,这似乎来自于一种相当侮辱性的假设,即没人会拼写),以至于为了速度而放弃质量?这很难!

我想知道顶级文档的大概成本(即使是以小时计算),以及每个级别或其中的项目(或许以节省的小时数计算)的成本效益分析。

我个人可以不需要贡献者文档、CLA、大多数按钮和徽章。我喜欢 CI 徽章,但有时构建是内部的,他们会有 jenkinsfile 或类似的,这消除了担忧。

最后一点更多的是一个问题。您认为 Issues 的目的是为了关闭,还是作为用户反馈和挫败感的活文档的一部分?

© . All rights reserved.