TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

GitHub Issues Do's and Don'ts

71 点作者 martyhu超过 8 年前

5 条评论

alangpierce超过 8 年前
I like this list, but I would also add &quot;Don&#x27;t worry so much about these rules.&quot;. At least for me, I&#x27;ve often wanted to contribute to an open source project or participate in a discussion, but I was scared to because I was worried that I would say something wrong or not follow some implicit norm. Probably, the whole &quot;RTFM culture&quot; (or at least my perception&#x2F;worry of it) had a net negative effect in my case because I ended up not contributing in cases where I probably could have positively contributed.<p>It really depends on your personality, though. If you&#x27;re the type of person who naturally just speaks your mind without hesitation, then it&#x27;s nice to slow down a bit and be more thoughtful, especially if you&#x27;re dealing with a complex topic or your comment will be read by many people. But if you&#x27;re more shy, you shouldn&#x27;t feel the need to go through this checklist 5 times before submitting any comment or PR.<p>Similarly, if you&#x27;re maintaining an open source project and someone breaks one of these &quot;rules&quot;, be polite and be thankful that they&#x27;re trying to help out. Allowing people to make little mistakes and learn from those mistakes is much more welcoming and human than &quot;you must read this giant list of docs before you&#x27;re allowed to speak&quot;. There&#x27;s a balance to everything, of course, but you&#x27;ll get a stronger community and help people grow if you&#x27;re more welcoming.
knocte超过 8 年前
This should not be targeted just to github issues users but to any bug reporting audience. (On a sidenote; I like gitlab issues so much more than github&#x27;s now, they have emulated trello to add dnd kanbas style to them)
rpedela超过 8 年前
I think there is an exception to the don&#x27;t +1 rule. I think saying +1 is fine as long as you follow up with an insightful comment. For example, explaining your specific use case for the feature because that information could help whoever implements it.
评论 #12383746 未加载
评论 #12383600 未加载
评论 #12383501 未加载
hrolff超过 8 年前
<a href="http:&#x2F;&#x2F;www.chiark.greenend.org.uk&#x2F;~sgtatham&#x2F;bugs.html" rel="nofollow">http:&#x2F;&#x2F;www.chiark.greenend.org.uk&#x2F;~sgtatham&#x2F;bugs.html</a>
sixhobbits超过 8 年前
I know it&#x27;s controversial, but I think<p>Dos and Don&#x27;ts<p>as is correct English grammar and faithful to the author&#x27;s title is strongly preferable to<p>Do&#x27;s and Don&#x27;ts<p>(Apostrophe is <i>never</i> used for pluralization, although I know that &quot;Dos&quot; looks really strange). The other option is to quote both words and to put the apostrophes outside the quotes<p>&quot;Do&quot;s and &quot;Don&#x27;t&quot;s