碰到的问题
担心闹乌龙
虽然在之前我已经调试过了无数次代码,但是心里还是没谱啊。毕竟我这么谨(cai)慎(ji)
的一个人,万一被人喷了怎么办?不知道你会不会这么想,反正我当时就是这么想的,如果你是这么想的,建议你去看看别人提交的 issue。搜索条件如下
is:closed label:"status: invalid"
我觉得你看几个,自然就有信心了!
不知道要怎么提交
每个开源的项目,只要作者希望这个项目越来越好的话,都会详细的说明如何给这个项目做开源贡献,Spring肯定也不例外,这里还是以提交 issue 为例,当你点击 New issue 的时候会出现下面这张图
在上图左边的框里很明确的告诉了你提交issue应该要注意什么
- 首先,你应该要去 Stack Overflow 提问
- 如果是 bug,你应该要指明版本以及你想要做什么
- 如果是一个增强的话,要提供上下文并且描述清楚问题
- 同一个问题,issue 跟 PR 最好只提交一个,因为 GitHub 认为它们是一样的,如果你还不能确定的话,先提交一个 issue
而右上角还有更加详细的文档可供参考。
英文
大家应该看到了,整个 issue 都是用英文写的,那么英文不好怎么办呢?这个时候就要掏出我们的神器了
嗯,就是词典,笔者习惯是使用有道词典。我建议英文不好的同学可以这样,先将整个 issue 用中文写好,如果你真的英文一窍不通的话,可以直接通过翻译软件逐句翻译,然后粘贴到 GitHub 上。但是千万千万不要使用中文,就像下面这个哥们
issue链接:https://github.com/spring-projects/spring-framework/pull/25127
像这种 issue 是会被直接打上 invalid(不合格)
标签的,你就想想吧,你学不会英文,你指望我们的外国朋友能看懂中文嘛?是我中华上线五千年的文化不够博大精深吗?
担心问题描述的不清楚
其实这个问题就是因为英文不好衍生出来的。因为英文不好,自然就会担心我写的东西他能不能看懂呢?我的建议就是,结合你测试的代码去描述问题。你不用去担心别人看不懂你写的代码,就以我那个 issue 的处理流程为例吧。
在你刚刚提交issue时,有专门的issuemaster
(issue管理员)会给你提交的 issue 打上一个 wait-for-triage
的标签,标志这个 issue 是待处理的。
随后我提交的这个 issue,就被指派给了jhoeller
。你要担心他看不懂代码吗?给你看两个东西吧
你知道那个红框是啥意思吗?就是说我发现的那个有问题代码的类的作者就是他。
再看一张
就是说,jhoeller
从 2003 年开始就已经是 Spring 这个项目的管理者以及发布经理了。2003 年,我还是一个小学生........
所以啊,只要你稍微正常点,基本上人家都能 get 到你的点。
给你的建议
其实笔者从发现这个问题到最终提交 issue 大概经过了一周时间,期间一直在犹豫要不要提交 issue,就是因为上面提到的几个问题,一直踌躇不前。但是等我下定决心要去做这件事的时候总共就花了几个小时的时间。包括研究issue 提交的规则以及写一篇英文版的 issue。并且我提交 issue 的第二天就马上被处理了,并且jhoeller
在 f9aae8d 这个 commit 中已经接受我的建议。
所以我要说的就是,
真正动手的话,不管什么问题总能找到解决方案
而只是停留在空想,在踌躇,你永远有一堆问题
临渊羡鱼,不如退而结网
以此文与君共勉!