stm32,几十个开源项目_每个开源项目经理都应考虑的5个技巧

stm32,几十个开源项目

在2013年的一项调查中 ，免费和开源软件贡献者中有11％被确定为女性。 但是，也许未来看起来更美好？ 我们可以通过检查女性参加Google Summer of Code的计划来回答这个问题，该计划为中学后的学生在夏季提供了开源软件的助学金。 从2011年到2015年 ，该计划由大约7-10％的女性参与者组成。 这是一个极低的百分比，对于开源多样性的未来来说并不是一个好兆头。

最近，北卡罗莱纳州立大学和圣路易斯·奥比斯波的加利福尼亚理工学院共同努力，发表了关于开源中的性别偏见的研究 。 尽管该研究已经广泛分发并由多家媒体进行了分析，但我将声明该研究尚未经过同行评审，以此来发表自己的分析。 此外，该研究的结果仅适用于GitHub用户群的约35％，无论从任何方面来看，它都不代表整个开源社区。 话虽如此，该研究确实得出结论，对于这一特定用户群，女性确实比男性更频繁地接受其拉取请求。 这是什么意思？ 我们可以得出结论，尽管在开放源代码贡献者中女性并不占多数，但其贡献与男性的贡献程度相同或更高。

看来，妇女是功能强大的开发商，但在开源社区中只占一小部分。 看起来，女性对开源的参与似乎并没有增加。 我们该如何改变呢？ 通过执行行为准则，有效地简化请求请求和问题上的沟通，为新贡献者创建一个健康而亲切的环境，建立非数字化空间并实行同理心，开源项目可以创建一个多元化且包容的社区。

行为守则

行为准则是​​任何开源软件项目的重要组成部分。 如果您是一家希望公开内部项目的公司，请确保已制定行为准则，然后再进行公开。 如果您是一个单独的开发人员，准备推动个人项目的首次公开提交，请在执行此操作之前确保已制定了行为准则。 对于行为准则是​​否应包含在代码库中，不应有任何犹豫或疑问。 我们有管辖我们的州，国家和全球社会的行为准则，那么为什么我们的软件中不存在行为准则？ 行为准则巩固了项目的期望和目标。 信不信由你，尽管您可能对项目社区中什么样的行为是可以接受的行为抱有期望，但有些人却对此并不满意。 行为准则有助于为围绕数字世界中行为的全球对话奠定基础。

您可以在项目中使用很多行为准则。 我个人建议使用贡献者契约 。 该文档的语言简单，简洁，易于理解，并且已经包含了几种翻译。 此外，它目前已被知名的开源项目（例如Atom和Ruby on Rails）使用 。

关于公关和议题的对话

拉取请求和问题可能是开源社区中最紧张的环境之一，这是正确的。 在其中，人们除了公开编写良好的代码和错误报告外，还公开匆忙编写的代码和半熟的功能请求。 拉取请求和问题的暴露性质使新老参与者都对他们在项目中的地位感到紧张。 因此，与在线空间中的其他开发人员进行交流时，保持文明，同理心和尊重的态度非常重要。 这个问题似乎没什么要问的，但是您会惊讶的是，情绪化的思维定型和易于使用的Enter键会对您造成多大的损害。

在数字空间中很难辨别出语气，而且我们经常最终将当前的情绪和背景应用于我们在网上阅读的内容。 如果您立即对请求或评论感到恼火或侮辱，请在其他时间再次阅读。 如果您仍然对评论的语气感到矛盾，请进行澄清。 永远不要（而且我再说一次，永远不要）对您的个人心态所助长的其他人的评论施加语气或意图。 这种简单的误会引发了许多误会和问题，并且可以通过给您正在沟通的人带来疑问的好处来轻松避免这种误解。

话虽这么说，分歧确实经常发生。 当他们确实感到激动或激动时，对于项目维护者来说，在每次讨论中坚持以下规则很重要：

• 批评思想，而不是思想家或他/她的能力。
• 在所有备受好评的讨论中都包括一位公正的主持人。
• 适当执行项目的行为准则。

您会注意到，在本节中我没有提及边缘化个人。 这是因为在拉取请求和问题上的负面互动会对所有贡献者产生负面影响，而来自边缘化背景的贡献者则更为不利。 当您必须时刻保持警惕，如何在空间中表达自己的语气和想法时，如果某人收到您的无害言论或负面要求不完美，则可能产生不利影响。

新贡献者的价值

新的贡献者是任何开源项目的命脉。 虽然有些人可能会想高举核心开发人员和维护人员，但实际上是新的贡献者维护了项目的精神。

新的贡献者阻止了开源开发团队的团派。 新的贡献者向项目介绍了有趣的新想法。 新的贡献者提出的想法与现状相反。 因此，在任何开源项目中，与新贡献者的有效互动都应放在首位。

在编写开源软件几年之后，您可能忘记了第一次创建存储库的感觉，紧张地敲击您认为不好的键盘代码，将鼠标悬停在“拉取请求”按钮上数小时的感觉。想知道如何收到您的捐款。 成为新的贡献者是一个在精神和精神上都筋疲力尽的过程，但是对于新的贡献者来说，有很多方法可以减少这种负担。

首先，确保您有良好的书面贡献准则很重要。 无论是简单的Markdown还是纯文本文件，请确保您的准则包含有关开发设置，测试驱动的开发过程，您使用的任何样式准则以及提交请求的任何过程的完整信息。 不要害怕复制其他地方存在的信息。 提供有关分支和克隆，创建分支以及提交更改的信息是完全合理的。 尽管作为准则的作者会给您带来很多负担，但它为新的参与者提供了参与项目的单一权威来源。

除了包括详尽的贡献准则之外，还应考虑包括一个截屏视频，该视频以可视化方式通过贡献工作流程吸引新的贡献者。 如果截屏视频过多，请考虑制作一个简短的信息图表来描述工作流程。 例如，查看我为Jupyter创建的贡献工作流程信息图 。 不同的人以不同的方式学习，并且为新的贡献者提供了不同的方式来学习如何参与您的项目，从而使他们知道您了解并牢记他们的独特观点。

但是，在新的贡献者甚至不能开始参与项目之前，他们必须知道他们可以做什么。 使用完成问题所需的贡献类型（文档，测试用例，功能，错误修复等），特定问题的难度（低，中，高）和优先级信息标记项目中的问题可以帮助新的贡献者在首次提出请求时找到完美的解决方案。 标记问题的类型和优先级相对容易，但是标记难度确实需要更多细微差别。 在标记问题的难度时，我认为重要的是要考虑以下问题：

• 解决此问题是否需要跨多个文件进行更改？
• 解决此问题是否需要特定主题的专门知识（线程，低级网络通信等）？
• 解决此问题是否涉及与代码库中未记录或未测试的部分进行交互？

回答这些问题，不仅可以帮助您向新贡献者提供更多信息，还可以帮助您评估自己的代码库的质量并致力于改进。

非数字空间的重要性

除了数字论坛外，有机会围绕一个开源项目建立现实世界的联系也很重要。 这些连接不必在围绕该项目的会议或聚会上进行，它们可以在任何地方进行。 当个人在现实世界中相互交往时，可以达到一定程度的尊重和友爱。 社区成员可以在当地的咖啡店或合作空间举办弹出式活动，包括协作编码，休闲对话和知识共享。 无论我们是否喜欢，人们都有不同的数字和现实角色，并且允许社区在Internet外部围绕您的项目进行开发，使具有强大社交技能的潜在贡献者有机会参与该项目。

增强同理心

在一个日益连接的世界中，期望在工作环境中与全国乃至全世界的人们一起编写软件。 全球交互在开放源代码中更加普遍，任何可以访问Internet和文本编辑器的人都可以了解开放源代码项目并为之做出贡献。 当我们试图与我们甚至在地图上可能无法识别的国家的人们进行技术和非技术对话时，这势必会引起很多紧张局势。 我们如何有效地遍历开源软件的多元文化生态系统？ 它涉及到您可能一次又一次听到的东西，但可能难以完全掌握：工程同理心。 我相信，移情是可以增强的肌肉。 也就是说，以下行为可以大大改善您的移情能力：

• 阅读由来自不同文化背景的开发人员撰写的技术博客文章。
• 观看与您所在国家/地区不同的国家/地区举行的会议中的技术演讲。
• 如果您能说一口流利的其他语言，请尝试阅读该语言的新闻。 这将使您了解在开源中成为非英语母语者的感觉。

这些技术将帮助您发现来自不同背景的开发人员如何思考，写作，说话和共享。 随着时间的流逝，您将对不同的人进行软件开发的方式产生一种远见和赞赏。

最后的想法

您会注意到，我描述的上述提示并非专门针对边缘化的人群。 当您创建一个欢迎和接纳边缘化个人的空间时，您就会创建一个欢迎每个人的接纳和空间。

翻译自: https://opensource.com/life/16/3/creating-welcoming-and-inclusive-open-source-space

stm32,几十个开源项目