Improving Contributing.md
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 42/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- bash, git, javascript, powershell
调研方向
打开 contributing.md 并检查列出的章节:开始之前、如何处理新功能、如何重构 Code、如何更新 Dependencies、如何编写新代码、如果我不知道该从哪里帮忙怎么办?、我完成了更改、有效使用 Git,以及 windows/powershell。应用所要求的拼写错误修正、语气调整、解释和鼓励,然后确认每个子任务都已处理,并且贡献指南对新贡献者来说仍然清晰易懂。
由索引模型根据 Issue 内容生成。
描述
Problem
Went through contributing.md doc to edit and find places where people might get confused or drop off. Found multiple typos and misspellings that need to be fixed as well as some possible places that could be reworded or edited for clarity.
Subtasks
- Add reach out encouragement like the one bolded below after "before you get started."
Before you get started
Fork the repo.
Read and work through the installation guide.
Run the tests. We only take pull requests with passing tests, and it's great to know that you have a >clean slate: ember exam. More information on testing commands can be found here
Stuck? Run into an issues doing this? Reach out on slack or email us at josh@codecorps.org or nikola@codecorps.org.
- Fix tone on opening paragraph of "How to tackle a new feature"
How to tackle a new feature
If there's already an issue for the feature you want to tackle, how complete is the description? Do >you know what to do next? Are you confident you know what "done" looks like?
This tone sounds really scary to me. It's almost sounds like, "If there's an issue to tackle, if you're not saying yes to these questions you should probably stay away." While these might be good things to ensure, the way this is stated might cause people to drop
- Replace line in "How to tackle a new feature" paragraph with more newbie friendly tone
Whether you're writing a new issue or improving on an existing issue, be sure to clarify exactly how you expect the finished change to look and work.
Would be more inviting if it were to be stated like:
Whether you're writing a new issue or improving on an existing issue, it’s important to be really clear on how you expect the finished change to look and work. be sure to clarify exactly how you expect the finished change to look and work.
- Add small explaination in How to refactor Code section:
I'm just thinking that if someone is looking at this for the first time. We might need a quick, "this is what refactoring is" if we don't want that in the doc, maybe we should link to another doc that explains it.
- Fix typo in "How to Update Dependencies Section"
depencency should be dependency - Cut word in "How to Write New code"
Try to keep your changes to a max of around 200 lines of code whenever possible. Why do this? >Apparently the more changes incurred in a pull request, the likelier it is that people who review >your code will just gloss over the details. Smaller pull requests get more comments and feedback >than larger ones. Crazy, right?
I'd cut "apparently."
- Add some newbie friendly anxiety killing wording in "What if I don't know where to help."
<What if I don't know how to help?
<Not a problem! You can try looking around for issues that say good for new contributors. <Documentation really is a good place to start. If you're still not sure, just join our Slack and flag someone down to pair with you. Someone can help point you in the right direction.
Something like the bolded line to encourage users to join slack or reach out to pair
- Add newbie encouragement Under "I finished my changes" section
Something like: At this point you're waiting on us. We like to at least comment on, if not accept, pull requests within a week's time. We may suggest some changes or improvements or alternatives. If you think you’re done, but don’t feel confident about your PR, don’t worry! Flag someone down in our slack channel and discuss what’s bothering you or got you stuck.
- Fix typo in "Using Git Effectively" section
When making code changes with Git, it is best to develop a workflow. Every 'feature', which can be anything from a 1-line change to an entire component, should be done on seperate feature branch.
Seperate should be separate.
- Consider tone in "Using windows/powershell"
If you are a Windows user, you should really be using Powershell as your command line (especially since it adopts bash aliases for most cmd.exe functions).
Might be nitpicky, but "you should really be using" sounds a little condescending. Consider rewriting.
- Fix typo in "Using windows/powershell"
You'll probably want to keep some sort of Bash emulator on hand. Git comes with it's own bash shell, but its not very good. Fortunately there are a few other great options:
"its" should be "it's"
- Fix typo in "Using windows/powershell"
Windows Subsystem for Linux More complex to use, but it gives you a full bash shell in an Ubuntu enviornment.
"Enviornment" should be "environment"
- 主要语言
- JavaScript
- 星标
- 120
- 派生
- 75
- PR 合并指标
- 30 天内没有已合并 PR
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
code-corps/code-corps-ember 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
code-corps/code-corps-ember#1616 ·
-
难度 2/5 1-3 小时 新手友好度 65/100
code-corps/code-corps-ember#1613 ·
-
难度 2/5 1-3 小时 新手友好度 72/100
code-corps/code-corps-ember#1612 ·
-
Difficulty: Medium Skill: ember-cli-page-object
难度 2/5 1-3 小时 新手友好度 62/100
code-corps/code-corps-ember#1063 · 1 个 reaction ·
-
greenkeeper
难度 3/5 1-2 天 新手友好度 25/100
code-corps/code-corps-ember#1765 · 1 条评论 ·
查看 code-corps/code-corps-ember 的全部 Issue
相似的 Issue
-
bug confirmed issue
难度 2/5 1-3 小时 新手友好度 75/100
open-webui/open-webui#30750 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 75/100
-
难度 2/5 1-3 小时 新手友好度 70/100
-
难度 2/5 1-3 小时 新手友好度 75/100
-
Mend: dependency security vulnerability untriaged
难度 2/5 1-3 小时 新手友好度 70/100