OpenSourceCamp

开放式协作沟通

姜宁

讲师介绍

  • TODO 添加讲师相关的内容

沟通的重要性

  • 招募用户和开发人员

  • 培养新贡献者

  • 自由讨论的同时做出必要的决策

  • 维护领域知识库，帮助新人和专家

  • 软件使用文档

书面交流的文化

  • 清晰的书面表达能力非常重要

  • 编程能力与技术问题描述能力有共通之处

  • 开源软件开发的受众背景知识不同

  • 如何保证大家在公共论坛保持建设性的沟通

文如其人

  • 在互联网上大家是通过你写的东西认识你

  • 你可能很聪明、有洞察力、有内涵

  • 表述清楚、有条理可以极大提升表达沟通的效率

结构与格式

  • 我们不是在聊天， 给出完整的上下文信息

  • 使用标准的语法和拼写，叙述需要连贯

  • 保持文本的易读性，让更多的人能够理解

  • 尽量避免歧义

内容

  • 采用最方便读者阅读的方式提供信息

  • 不要夸大其词，采用技术中立的描述语言

  • 发送邮件之前，花点时间检查撰写的内容

语气

  • 在撰写了几千封邮件之后， 邮件风格会趋向简洁

  • 重点在于表述问题，没有问候，没有签名。

  • 采用技术语言的沟通方式，目的是为了解决问题

  • 可以结尾加上祝福，打破冷漠的尴尬

避免粗鲁

  • 不是粗鲁的表现

    • 技术性批评、不加修饰的技术批评

    • 直率、朴实无华的提问

  • 粗鲁的表现

    • 没有详细描述的无端批评

    • 针对个人的评论，人身攻击

个人标识（面孔）

  • 网络世界直观的认识，真实的网络名称

  • 邮件的个人签名

  • 头像Avatar

常规的邮件讨论

  • 需要习惯公开的邮件讨论

  • 注意交流的语气

  • 学会使用邮件列表

    • 订阅邮件列表

    • 在邮箱中管理订阅的邮件

撰写邮件常见问题

  • 发邮件的目的性不明

  • 邮件线索(Thread) 不清晰

  • 邮件话题之争

  • 避免圣战讨论

  • 灌水的问题

电子邮件格式约定

  • 只发送纯文本邮件

  • 有清晰的格式标明段落

  • 代码或者错误消息保持在80列宽

  • 引用别人邮件时，将回复插入最合适的位置

  • 邮件标题一定要认真写

使用邮件列表

  • 通过邮件列表存档查询历史邮件

  • 订阅邮件列表获取信息

  • 邮件列表也有审核

  • 常规的邮件列表 dev@, users@

Github issue

Github issue 高级功能

PR review

参考资料

问题

  • 大家可以现场提问

  • 在演讲之后沟通

  • 给我发送邮件