Hi,

+1

Besides, when reporting bugs, it's better to list the reproduction procedure.

Thanks,
--
Jialin Qiao
School of Software, Tsinghua University

乔嘉林
清华大学 软件学院

> -----原始邮件-----
&gt; 发件人: "Jesse Zhou" <[email protected]>
&gt; 发送时间: 2020-12-31 15:38:45 (星期四)
&gt; 收件人: [email protected]
&gt; 抄送: 
&gt; 主题: Re: Advocate more standard commit process(with pictures)
&gt; 
&gt; +1
&gt; 
&gt; Agree. A standardized flow is crucial for a growing project.
&gt; 
&gt; Xiangwei Wei <[email protected]> 于2020年12月30日周三 下午4:12写道:
&gt; 
&gt; &gt; Hi all,
&gt; &gt;
&gt; &gt; Recently I found there are some problems existing in the commit 
process of
&gt; &gt; IoTDB and it's getting worse.
&gt; &gt;
&gt; &gt; Let's see the actual situation directly. (The screenshots are just
&gt; &gt; examples, there is no offence.)
&gt; &gt;
&gt; &gt; First,
&gt; &gt;
&gt; &gt; It's necessary to create an issue and pull a request for each commit.
&gt; &gt; Maybe some commits are simple enough to ignore an issue, like doc
&gt; &gt; modification, but *it's still important to pull a request and have a
&gt; &gt; review*. We should try our best to *avoid pushing to the repository
&gt; &gt; directly.* The following is a good example:
&gt; &gt;
&gt; &gt; [image: QQ截图20201230161050.png]
&gt; &gt;
&gt; &gt; Secondly,
&gt; &gt; We don't have enough information for each commit now.
&gt; &gt;
&gt; &gt; Let's see the git log of HBase, thanks to the help of @Yuqi. :D
&gt; &gt;
&gt; &gt; [image: image.png]
&gt; &gt;
&gt; &gt; *In each commit, *
&gt; &gt; *1. the issue number*
&gt; &gt; *2. the summarization of commit*
&gt; &gt; *3. the PR number *
&gt; &gt; *4. the PR reviewers  are included.*
&gt; &gt; It's a very standard process I think. It's great if we can use it for
&gt; &gt; reference.
&gt; &gt;
&gt; &gt; The following are some bad examples of ours:
&gt; &gt;
&gt; &gt; [image: image (1).png]
&gt; &gt; [image: image (2).png]
&gt; &gt; [image: image (3).png]
&gt; &gt;
&gt; &gt; Since the contributors don't have write privilege, *so all people who
&gt; &gt; have the privilege to merge pull requests should be aware of this. Be
&gt; &gt; great, be standard.*
&gt; &gt;
&gt; &gt;
&gt; &gt; *Thirdly, Do not force-push a commit if someone has reviewed your 
code.*
&gt; &gt; It's a large workload to review a PR if it involves many files. And 
if you
&gt; &gt; force-push a commit, which means the reviewers have to check all 
modified
&gt; &gt; files again. Maybe you just want to reduce the number of your local
&gt; &gt; commits, but it's still not a good habit.
&gt; &gt;
&gt; &gt; *Fourthly, Use squash merge.*
&gt; &gt; It's related to topic 3. Since each pull request may involve many 
commits
&gt; &gt; the author commits, it's better to squash it as one commit when 
merging it
&gt; &gt; into master.
&gt; &gt;
&gt; &gt;
&gt; &gt; We are a young project indeed. Let's make our efforts to make it 
better.
&gt; &gt; If you have any advice, please leave your opinion. :D
&gt; &gt;
&gt; &gt; --
&gt; &gt; Best,
&gt; &gt; Xiangwei Wei
&gt; &gt;
</[email protected]></[email protected]>

Reply via email to