Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

思考:开源协作中需要注意的一些表达方式 #42

Open
LinuxSuRen opened this issue Dec 24, 2021 · 2 comments
Open

思考:开源协作中需要注意的一些表达方式 #42

LinuxSuRen opened this issue Dec 24, 2021 · 2 comments

Comments

@LinuxSuRen
Copy link
Owner

LinuxSuRen commented Dec 24, 2021

好的语言表达方式,会起到比较好的效果,大家在阅读的时候感到舒适。但,一不小心的“表达方式”、“语言句式”可能会让其他人感觉到不舒服:

推荐的

  • Investigating it, sorry for inconvenience

避免的

  • 麻烦添加一个 xxx 功能、修复一个 issue

  • 所以,请认真看一下文档

    • 听起来可能有“责备嫌疑”
  • 我们很需要 xxx,这个对我们很重要,可以 xxx 吗

    • 伸手党来要东西,拿来主义
  • I want something

  • Please fix xxx

    • [Suggestion] I'm wondering if you could see why xx is wrong
  • Why don't do something like xxx

    • [Suggestion] I'm thinking if we can try another solution xx

欢迎补充“好的”、“坏的”案例

@kang8
Copy link
Contributor

kang8 commented Apr 9, 2022

当你是第一次贡献代码时,大胆的说出你的背景,这没有什么丢脸的,反而会让其他人有效的帮助你。

For example:

This is my first PR here so sorry if there is not enough examples, let me know if I should add more.

From rstacruz/cheatsheets#1554 (comment)

@LinuxSuRen
Copy link
Owner Author

发现一个非常有趣的功能,它可以自动检测文案可能体现出来的语气、亦或是给读着的感觉。来看截图了
image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants