<div dir="ltr"><div class="gmail_quote"><div dir="ltr">On Wed, Dec 12, 2018 at 8:06 PM Liu, Changcheng <<a href="mailto:changcheng.liu@intel.com">changcheng.liu@intel.com</a>> wrote:<span style="font-size:10pt;font-family:"Bookman Old Style""> </span></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><font face="Bookman Old Style" size="2"><span style="font-size:10pt">
<div> 2. <b>[Dean] </b><b>the references to the original commit are not available externally</b></div>
<div> [Changcheng] Yes. The reference should be removed from commit message at last.</div>
<div> Originally, I want both Intel & WindRiver engineers could find where the patches are ported from which place at the initial porting stage.</div></span></font></blockquote><div> </div><div>[dt] The reference should NOT be removed. If a patch is being rebased the reference to the original patch must be preserved.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><font face="Bookman Old Style" size="2"><span style="font-size:10pt"><div></div>
<div style="text-indent:12pt">3. <b>[Dean] </b><b>It also seems like it would be easier to review and merge these in smaller batches.</b></div>
<div> [Changcheng] Yes. I’m syncing with WindRiver engineers to check whether we could merge some patches firstly to avoid times of rebase and review.</div>
<div style="text-indent:12pt"><font face="Times New Roman"></font></div></span></font></div></blockquote><div><br></div><div>[dt] I am not talking about merging commits, I am talking about splitting the existing commits into multiple Github PRs. Please do not merge commits that are not directly related to each other..</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><font face="Bookman Old Style" size="2"><span style="font-size:10pt">
<div> 4. <b>[Dean] </b><b>There is also no reference in either the commit messages or the PR description to a Storyboard story or task or any further documentation to why this work is being done.</b></div>
<div> [Changcheng] I’ll add related information in PR message if we agree with merge part of patches firstly.</div></span></font></div></blockquote><div><br></div><div>Please put it into the commit messages. The PR text is not part of the git repo and is lost github is unavailable.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><font face="Bookman Old Style" size="2"><span style="font-size:10pt">
<div> 5. <b>[Dean] </b><b>only the git commit messages are guaranteed to stay with the code changes.</b></div>
<div> [Changcheng] We’ll give document about stx-ceph upgrade once it’s been upgraded successfully.</div></span></font></div></blockquote><div><br></div><div>That does not address the need to put good information into the individual commit messages.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><font face="Bookman Old Style" size="2"><span style="font-size:10pt">
<div style="text-indent:12pt">6. <b>[</b><b>Dean</b><b>]</b><b> </b><b>I had asked for the relevant information to be included in the individual commit messages and I still do not see that being done. We are losing valuable information and traceability for
why we are making these changes to upstream.</b></div>
<div> [Changcheng] Personally, I think I’ve kept most part of original commit message in the new ported patches. Some huge patch is divided into small patches(If you look the original patch, it’s merged by several patches. It’s hard to be maintained).
For PR info, we could give more detail info according to your requirement.</div></span></font></div></blockquote><div><br></div><div>Thank you for splitting up previously squashed patches. Please do not confuse PR information (the text that is part of a Github PR) with a commit message (the text that is part of a git commit). Github PRs are not the place of record for us. Information that does not fit into a git commit message should be in Storyboard or Launchpad, the two places we keep track of those things. But more importantly, things that the next team that looks at this code will want to have without access to Github or Storyboard or Launchpad needs to be in the commit message. This is exactly the problem we have with the existing patches agains upstream code where we have commitmessages sometimes with only a link to a ticketing system that we do not have access to. I do not want that to continue.</div><div><br></div><div>dt</div><div><br></div></div>-- <br><div dir="ltr" class="gmail_signature"><br>Dean Troyer<br><a href="mailto:dtroyer@gmail.com" target="_blank">dtroyer@gmail.com</a><br></div></div>