790 积分 | 连接 lewiscowles 埃塞克斯,英国 我在伦敦一家金融科技创业公司工作。我非常喜欢结对编程、认知和教育以及可重复性。和我聊聊测试、自动化或者任何你热衷的事情。 开源布道者 Python 网页开发者 Wordpress 开发者 Docker 极客 Java Ubuntu 作者 DevOps 云 Linux 开放教育 开放政府 PHP
发表的评论
我购买了平装本并已下载。我真诚希望作者能从平装本中获得一些收入,因为我注意到价格低于 LuLu 通常的收费。
非常有趣。
我喜欢简洁、文笔好、易于维护的文档,我不认为这些文档就逊色。
我发现“世界奇观”式的努力似乎最容易腐烂。它们需要付出艰苦的努力来修订,或者有非常糟糕的搜索和浏览机制(即使内容在那里也没用,如果我必须 grep 才能找到特定的措辞,那就会有问题)。
这也不是作者的缺点。如何设计一个通过标题、标签和措辞进行一致搜索的系统,它具有易于理解的 UI,又不会像 Elasticsearch 支持的系统那样过于宽松(在我看来,这似乎来自于一种相当侮辱性的假设,即没人会拼写),以至于为了速度而放弃质量?这很难!
我想知道顶级文档的大概成本(即使是以小时计算),以及每个级别或其中的项目(或许以节省的小时数计算)的成本效益分析。
我个人可以不需要贡献者文档、CLA、大多数按钮和徽章。我喜欢 CI 徽章,但有时构建是内部的,他们会有 jenkinsfile 或类似的,这消除了担忧。
最后一点更多的是一个问题。您认为 Issues 的目的是为了关闭,还是作为用户反馈和挫败感的活文档的一部分?