为什么在开源中获得文档编写经验很困难

主要观点:常听闻参与开源项目是积累文档经验的最佳方式之一,但实际做起来难,介绍了参与开源项目积累文档经验面临的挑战。
关键信息:

  • 参与开源项目的两种编辑类型(除 minor edits 外的有价值贡献)。
  • 一些开源项目并非如想象中开放,存在限制新人贡献的结构及不同态度的维护者。
  • 缺乏文档本身是贡献的最大障碍之一,项目常因资源等原因忽视文档。
  • 审核和反馈的人力有限,找人为工作提供反馈有难度。
  • 缺乏项目技术经验需花费大量时间学习。
    重要细节:
  • 维护者对新人态度不同,应感谢时间并寻找更开放社区的项目。
  • 找到与自身技术背景相符的项目能使贡献更易且愉快。
  • 维护者投入时间谨慎,需通过定期小贡献建立信任。
    结论:通过开源积累文档经验需时间和规划,虽有挑战但不应停止尝试,可通过找匹配项目、了解项目及社区等方式来应对。
阅读 11
0 条评论