IOHK官网博客:记录Cardano-适应未来的开发者事实单一来源

image
原文及图片来自IOHK官网博客,原作者为Tim Harrison,由卡尔达诺大使陈哲Anson翻译

随着昨天Cardano主网上发布第一个Shelley-complete节点,新时代开启。在此之间推出了全新的Cardano网站和品牌标识,以及明天的Cardano虚拟峰会,Shelley的曙光为IOHK的未来提供了新的亮点,它还突出了需要适合我们快速发展的生态系统的文档框架。

我们多年来已经在Cardano上撰写并收集了大量技术资料,这一切毫无疑问,已经有序地发展了,并且具有可变的质量和实用性,不过并非所有内容都保持准确或有用。Shelley的部署,开发人员兴趣的不断增强以及Cardano的发展使我们从项目转向了产品。因此,这就需要重新审视我们对卡尔达诺的解释。

卡尔达诺的用户和消费者需要具有清晰、简洁的相关材料,以与构建区块链的代码的质量相匹配。文档必须是正确和有用的,尽然有序和聚焦的。此外,我们发现有必要将信息类别映射到每个用户组或角色。我们正在构建一流的区块链,这需要高质量的支持文档。旧的Cardano文档站点非常需要重组和更新,而我们的技术领域的作者一直在忙着这样做。欢迎大家使用新的Cardano文档。

未来的文档

卡尔达诺是具有复杂技术基础的复杂产品。但是,对于开发人员社区和更广泛的受众来说,我们需要他们了解它如何提供有用的体验,需要知道Cardano可以做什么以及如何解决问题。为了确保我们为所有用户提供正确的信息,我们正在重新组织文档套件并映射每个受众的需求。

在过去的几个月中,IOHK一直在全公司范围内努力修改Cardano项目的所有内容。我们的技术写作团队一直致力于转换以前的存储库,与我们的开发人员团队紧密合作,以创建技术事实的单一来源,提供有效,翔实和最新信息的资源,从而提供价值给到广泛的观众:交易伙伴,权益池,经验丰富的区块链开发人员,以及想了解卡尔达诺的人。这也同样适合老练的加密爱好者以及那些只想从技术角度了解卡尔达诺的人。

因此,我们今天将启动一个新的文档站点,该站点现在不再是静态的存储库,而是关于Cardano的实时信息源,已插入我们开发方法的核心,它就像卡尔达诺一样,这是一个不断发展的实体。在我们努力改善所提供内容的过程中,我们会定期添加组件,新功能一直在实施。我们还打算根据我们的计划和社区反馈发布更多文档。我们需要根据对我们的用户有效的方式(无论是在技术领域还是商业领域)进行扩展。

作为Cardano社区的成员,您可以参与其中,通过专用的GitHub帮助我们改善文档。许多新面孔会通过虚拟峰会,靠着持续不断的动力加入我们的生态系统。我们现在有了一个起点,能够建立起可靠的开发人员事实的单一来源。

原文链接:https://iohk.io/zh/blog/posts/2020/07/01/documenting-cardano-a-single-source-of-developer-truth-fit-for-the-future/