Moving this back to the mailing list...
On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > David E. Jones wrote: >> When reviewing a patch lines with formatting changes only are >> EXTREMELY time consuming, and the patch attached that issue is a >> good example of a painful one. For each of those line you have to >> stare at it looking at every character trying to figure out what >> the point of the bloody change was, or to make sure that the >> change is "invisible"... > > That really puzzles me. You keep mentioning formatting changes when > I don't see any. I didn't make any formatting changes when > modifying the files. Even now when I look at the patch in Jira, it > shows only the lines I changed in the file. > > *shrug* list. Below is the first section from the framework_v2.patch file on the [https://issues.apache.org/jira/browse/OFBIZ-605] issue. Each change is marked with a "-" for a line removed or a "+" for a line added. First Set: formatting, or "invisible" change Second Set: add comment (not necessary, BTW as it describes something that no longer exists; if people want to see old stuff they can look at the SVN history); remove tabstyles.css link tag Third Set: formatting, or "invisible" change Of all of these changes, only the "remove tabstyles.css link tag" was actually intended and necessary, but getting to this fact when reviewing the changes takes some time... this making it more difficult to review, commit, etc. People tend to slip things into patches accidentally all the time. I'm tempted to begun the voting process for a new policy that says that if there is anything in the patch file not described in the summary of the patch, then it will be rejected... -David ======================== Index: common/webcommon/includes/header.ftl =================================================================== --- common/webcommon/includes/header.ftl (revision 494159) +++ common/webcommon/includes/header.ftl (working copy) @@ -27,7 +27,7 @@ <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <title>${layoutSettings.companyName}: <#if (page.titleProperty)? has_content>${uiLabelMap[page.titleProperty]}<#else>${(page.title)? if_exists}</#if></title> - <link rel="shortcut icon" href="<@ofbizContentUrl>/images/ ofbiz.ico</@ofbizContentUrl>" /> + <link rel="shortcut icon" href="<@ofbizContentUrl>/images/ ofbiz.ico</@ofbizContentUrl>" /> <script language="javascript" src="<@ofbizContentUrl>/images/ calendar1.js</@ofbizContentUrl>" type="text/javascript"></script> <script language="javascript" src="<@ofbizContentUrl>/images/ selectall.js</@ofbizContentUrl>" type="text/javascript"></script> <script language="javascript" src="<@ofbizContentUrl>/images/ fieldlookup.js</@ofbizContentUrl>" type="text/javascript"></script> @@ -37,8 +37,8 @@ <link rel="stylesheet" href="<@ofbizContentUrl>$ {styleSheet}</@ofbizContentUrl>" type="text/css"/> </#list> <#else> + <#-- tabstyles.css has been moved to maincss.css --> <link rel="stylesheet" href="<@ofbizContentUrl>/images/ maincss.css</@ofbizContentUrl>" type="text/css"/> - <link rel="stylesheet" href="<@ofbizContentUrl>/images/ tabstyles.css</@ofbizContentUrl>" type="text/css"/> </#if> ${layoutSettings.extraHead?if_exists} </head> @@ -51,7 +51,7 @@ <tr> <#if layoutSettings.headerImageUrl?exists> <td align="left" width="1%"><img alt="$ {layoutSettings.companyName}" src="<@ofbizContentUrl>$ {layoutSettings.headerImageUrl}</@ofbizContentUrl>"/></td> - </#if> + </#if> <td align="right" width="1%" nowrap="nowrap" <#if layoutSettings.headerRightBackgroundUrl?has_content>background="$ {layoutSettings.headerRightBackgroundUrl}"</#if>> <div class="insideHeaderText"> <#if person?has_content> ====================== smime.p7s (3K) Download Attachment |
Looking at his patch, I don't believe Adrian made the
formatting changes. His editor did. It's clearing whitespace at the end of lines in places you wouldn't even expect him to be touching (the license header). Adrian, what IDE and xml editor are you using? There's probably a setting somewhere to prevent this from (or causing to - depending on your perspective)happening. --- "David E. Jones" <[hidden email]> wrote: > Moving this back to the mailing list... > > > On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > > > David E. Jones wrote: > >> When reviewing a patch lines with formatting > changes only are > >> EXTREMELY time consuming, and the patch attached > that issue is a > >> good example of a painful one. For each of those > line you have to > >> stare at it looking at every character trying to > figure out what > >> the point of the bloody change was, or to make > sure that the > >> change is "invisible"... > > > > That really puzzles me. You keep mentioning > formatting changes when > > I don't see any. I didn't make any formatting > changes when > > modifying the files. Even now when I look at the > patch in Jira, it > > shows only the lines I changed in the file. > > > > *shrug* > > As others may have the same question I'll answer it > on the mailing > list. Below is the first section from the > framework_v2.patch file on > the > [https://issues.apache.org/jira/browse/OFBIZ-605] > issue. > > Each change is marked with a "-" for a line removed > or a "+" for a > line added. > > First Set: formatting, or "invisible" change > > Second Set: add comment (not necessary, BTW as it > describes something > that no longer exists; if people want to see old > stuff they can look > at the SVN history); remove tabstyles.css link tag > > Third Set: formatting, or "invisible" change > > Of all of these changes, only the "remove > tabstyles.css link tag" was > actually intended and necessary, but getting to this > fact when > reviewing the changes takes some time... this making > it more > difficult to review, commit, etc. > > People tend to slip things into patches accidentally > all the time. > I'm tempted to begun the voting process for a new > policy that says > that if there is anything in the patch file not > described in the > summary of the patch, then it will be rejected... > > -David > > > ======================== > Index: common/webcommon/includes/header.ftl > > --- common/webcommon/includes/header.ftl (revision > 494159) > +++ common/webcommon/includes/header.ftl (working > copy) > @@ -27,7 +27,7 @@ > <head> > <meta http-equiv="Content-Type" > content="text/html; > charset=UTF-8"/> > <title>${layoutSettings.companyName}: <#if > (page.titleProperty)? > > > if_exists}</#if></title> > - <link rel="shortcut icon" > href="<@ofbizContentUrl>/images/ > ofbiz.ico</@ofbizContentUrl>" /> > + <link rel="shortcut icon" > href="<@ofbizContentUrl>/images/ > ofbiz.ico</@ofbizContentUrl>" /> > <script language="javascript" > src="<@ofbizContentUrl>/images/ > calendar1.js</@ofbizContentUrl>" > type="text/javascript"></script> > <script language="javascript" > src="<@ofbizContentUrl>/images/ > selectall.js</@ofbizContentUrl>" > type="text/javascript"></script> > <script language="javascript" > src="<@ofbizContentUrl>/images/ > fieldlookup.js</@ofbizContentUrl>" > type="text/javascript"></script> > @@ -37,8 +37,8 @@ > <link rel="stylesheet" > href="<@ofbizContentUrl>$ > {styleSheet}</@ofbizContentUrl>" type="text/css"/> > </#list> > <#else> > + <#-- tabstyles.css has been moved to > maincss.css --> > <link rel="stylesheet" > href="<@ofbizContentUrl>/images/ > maincss.css</@ofbizContentUrl>" type="text/css"/> > - <link rel="stylesheet" > href="<@ofbizContentUrl>/images/ > tabstyles.css</@ofbizContentUrl>" type="text/css"/> > </#if> > ${layoutSettings.extraHead?if_exists} > </head> > @@ -51,7 +51,7 @@ > <tr> > <#if > layoutSettings.headerImageUrl?exists> > <td align="left" width="1%"><img alt="$ > {layoutSettings.companyName}" > src="<@ofbizContentUrl>$ > > - </#if> > + </#if> > <td align="right" width="1%" > nowrap="nowrap" <#if > layoutSettings.headerRightBackgroundUrl?has_content>background="$ > > {layoutSettings.headerRightBackgroundUrl}"</#if>> > <div class="insideHeaderText"> > <#if person?has_content> > ====================== > > |
In reply to this post by David E Jones
David,
I agree with the rejection policy. One suggestion on procedure to take when self-reviewing a patch before submitting it. Look at the diff to see if there are changes we cannot account for. Using KDiff also makes things easier, even when dealing with formatting changes. In Emacs, it's also easy to go through every set of changes, do an interactive-search for 1st entry of each set, and see if the 2nd entry is highlighted similarly. Meaning, if it is highlighted similarly, the set of changes is bogus (formatting only). In general, we should submit patches that are intentional, ie just the intended changes only. We should not submit patches that contain unintended changes that have extra unintended footprints. Jonathon David E. Jones wrote: > Moving this back to the mailing list... > > > On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > >> David E. Jones wrote: >>> When reviewing a patch lines with formatting changes only are >>> EXTREMELY time consuming, and the patch attached that issue is a >>> good example of a painful one. For each of those line you have to >>> stare at it looking at every character trying to figure out what the >>> point of the bloody change was, or to make sure that the change is >>> "invisible"... >> >> That really puzzles me. You keep mentioning formatting changes when I >> don't see any. I didn't make any formatting changes when modifying the >> files. Even now when I look at the patch in Jira, it shows only the >> lines I changed in the file. >> >> *shrug* > > As others may have the same question I'll answer it on the mailing list. > Below is the first section from the framework_v2.patch file on the > [https://issues.apache.org/jira/browse/OFBIZ-605] issue. > > Each change is marked with a "-" for a line removed or a "+" for a line > added. > > First Set: formatting, or "invisible" change > > Second Set: add comment (not necessary, BTW as it describes something > that no longer exists; if people want to see old stuff they can look at > the SVN history); remove tabstyles.css link tag > > Third Set: formatting, or "invisible" change > > Of all of these changes, only the "remove tabstyles.css link tag" was > actually intended and necessary, but getting to this fact when reviewing > the changes takes some time... this making it more difficult to review, > commit, etc. > > People tend to slip things into patches accidentally all the time. I'm > tempted to begun the voting process for a new policy that says that if > there is anything in the patch file not described in the summary of the > patch, then it will be rejected... > > -David > > > ======================== > Index: common/webcommon/includes/header.ftl > =================================================================== > --- common/webcommon/includes/header.ftl (revision 494159) > +++ common/webcommon/includes/header.ftl (working copy) > @@ -27,7 +27,7 @@ > <head> > <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> > <title>${layoutSettings.companyName}: <#if > (page.titleProperty)?has_content>${uiLabelMap[page.titleProperty]}<#else>${(page.title)?if_exists}</#if></title> > > - <link rel="shortcut icon" > href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" /> > + <link rel="shortcut icon" > href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" /> > <script language="javascript" > src="<@ofbizContentUrl>/images/calendar1.js</@ofbizContentUrl>" > type="text/javascript"></script> > <script language="javascript" > src="<@ofbizContentUrl>/images/selectall.js</@ofbizContentUrl>" > type="text/javascript"></script> > <script language="javascript" > src="<@ofbizContentUrl>/images/fieldlookup.js</@ofbizContentUrl>" > type="text/javascript"></script> > @@ -37,8 +37,8 @@ > <link rel="stylesheet" > href="<@ofbizContentUrl>${styleSheet}</@ofbizContentUrl>" type="text/css"/> > </#list> > <#else> > + <#-- tabstyles.css has been moved to maincss.css --> > <link rel="stylesheet" > href="<@ofbizContentUrl>/images/maincss.css</@ofbizContentUrl>" > type="text/css"/> > - <link rel="stylesheet" > href="<@ofbizContentUrl>/images/tabstyles.css</@ofbizContentUrl>" > type="text/css"/> > </#if> > ${layoutSettings.extraHead?if_exists} > </head> > @@ -51,7 +51,7 @@ > <tr> > <#if layoutSettings.headerImageUrl?exists> > <td align="left" width="1%"><img > alt="${layoutSettings.companyName}" > src="<@ofbizContentUrl>${layoutSettings.headerImageUrl}</@ofbizContentUrl>"/></td> > > - </#if> > + </#if> > <td align="right" width="1%" nowrap="nowrap" <#if > layoutSettings.headerRightBackgroundUrl?has_content>background="${layoutSettings.headerRightBackgroundUrl}"</#if>> > > <div class="insideHeaderText"> > <#if person?has_content> > ====================== > |
I don't know that rejection policies are very
community friendly. Treating SVN code changes like the keeper of the Bridge of Death (Monty Python Reference, smile) may find less people willing to do in this do-ocracy. Many of us rather like what's left of our anarco-sydicalist commune (oh look, there's another :-) ). --- Jonathon -- Improov <[hidden email]> wrote: > David, > > I agree with the rejection policy. > > One suggestion on procedure to take when > self-reviewing a patch before submitting it. Look at > the > diff to see if there are changes we cannot account > for. Using KDiff also makes things easier, even > when dealing with formatting changes. > > In Emacs, it's also easy to go through every set of > changes, do an interactive-search for 1st > entry of each set, and see if the 2nd entry is > highlighted similarly. Meaning, if it is > highlighted similarly, the set of changes is bogus > (formatting only). > > In general, we should submit patches that are > intentional, ie just the intended changes only. We > should not submit patches that contain unintended > changes that have extra unintended footprints. > > Jonathon > > David E. Jones wrote: > > Moving this back to the mailing list... > > > > > > On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > > > >> David E. Jones wrote: > >>> When reviewing a patch lines with formatting > changes only are > >>> EXTREMELY time consuming, and the patch > attached that issue is a > >>> good example of a painful one. For each of > those line you have to > >>> stare at it looking at every character trying > to figure out what the > >>> point of the bloody change was, or to make sure > that the change is > >>> "invisible"... > >> > >> That really puzzles me. You keep mentioning > formatting changes when I > >> don't see any. I didn't make any formatting > changes when modifying the > >> files. Even now when I look at the patch in Jira, > it shows only the > >> lines I changed in the file. > >> > >> *shrug* > > > > As others may have the same question I'll answer > it on the mailing list. > > Below is the first section from the > framework_v2.patch file on the > > [https://issues.apache.org/jira/browse/OFBIZ-605] > issue. > > > > Each change is marked with a "-" for a line > removed or a "+" for a line > > added. > > > > First Set: formatting, or "invisible" change > > > > Second Set: add comment (not necessary, BTW as it > describes something > > that no longer exists; if people want to see old > stuff they can look at > > the SVN history); remove tabstyles.css link tag > > > > Third Set: formatting, or "invisible" change > > > > Of all of these changes, only the "remove > tabstyles.css link tag" was > > actually intended and necessary, but getting to > this fact when reviewing > > the changes takes some time... this making it more > difficult to review, > > commit, etc. > > > > People tend to slip things into patches > accidentally all the time. I'm > > tempted to begun the voting process for a new > policy that says that if > > there is anything in the patch file not described > in the summary of the > > patch, then it will be rejected... > > > > -David > > > > > > ======================== > > Index: common/webcommon/includes/header.ftl > > > > > --- common/webcommon/includes/header.ftl > (revision 494159) > > +++ common/webcommon/includes/header.ftl > (working copy) > > @@ -27,7 +27,7 @@ > > <head> > > <meta http-equiv="Content-Type" > content="text/html; charset=UTF-8"/> > > <title>${layoutSettings.companyName}: <#if > > > > > > > > - <link rel="shortcut icon" > > > href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" > /> > > + <link rel="shortcut icon" > > > href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" > /> > > <script language="javascript" > > > src="<@ofbizContentUrl>/images/calendar1.js</@ofbizContentUrl>" > > > type="text/javascript"></script> > > <script language="javascript" > > > src="<@ofbizContentUrl>/images/selectall.js</@ofbizContentUrl>" > > > type="text/javascript"></script> > > <script language="javascript" > > > src="<@ofbizContentUrl>/images/fieldlookup.js</@ofbizContentUrl>" > > > type="text/javascript"></script> > > @@ -37,8 +37,8 @@ > > <link rel="stylesheet" > > > href="<@ofbizContentUrl>${styleSheet}</@ofbizContentUrl>" > type="text/css"/> > > </#list> > > <#else> > > + <#-- tabstyles.css has been moved to > maincss.css --> > > <link rel="stylesheet" > > > href="<@ofbizContentUrl>/images/maincss.css</@ofbizContentUrl>" > > > type="text/css"/> > > - <link rel="stylesheet" > > > href="<@ofbizContentUrl>/images/tabstyles.css</@ofbizContentUrl>" > > > type="text/css"/> > > </#if> > > ${layoutSettings.extraHead?if_exists} > > </head> > > @@ -51,7 +51,7 @@ > > <tr> > > <#if > layoutSettings.headerImageUrl?exists> > > <td align="left" width="1%"><img > > alt="${layoutSettings.companyName}" > > > > > > > > - </#if> > > + </#if> > > <td align="right" width="1%" > nowrap="nowrap" <#if > > > layoutSettings.headerRightBackgroundUrl?has_content>background="${layoutSettings.headerRightBackgroundUrl}"</#if>> > > > > > <div class="insideHeaderText"> > > <#if person?has_content> > > ====================== > > > > |
Heh. True. I definitely want MORE people involved in OFBiz.
But since I'm not a committer, I'd rather make things easier for the committers. I have no control over how easy or difficult it is to handle patches with "extra unintended footprints". If I were a committer, I would try to automatically filter out formatting changes in my audit, and then INCLUDE the formatting changes. After all, there's no harm removing some extra spaces at the end of lines, part of clean up. We often try to make things easier for the person who is doing a task that we have no control over. Eg, I'd keep my mouth really wide open for my dentist just so his vision is 20/20, no arguments from me; I could afford to be slack about this "mouth wide-open policy" if I were able to do the dentistry myself. But you're certainly right that it'll exclude some people, especially folks who use editors that do not give very much control to users. Jonathon Chris Howe wrote: > I don't know that rejection policies are very > community friendly. Treating SVN code changes like > the keeper of the Bridge of Death (Monty Python > Reference, smile) may find less people willing to do > in this do-ocracy. Many of us rather like what's left > of our anarco-sydicalist commune (oh look, there's > another :-) ). > > > --- Jonathon -- Improov <[hidden email]> wrote: > >> David, >> >> I agree with the rejection policy. >> >> One suggestion on procedure to take when >> self-reviewing a patch before submitting it. Look at >> the >> diff to see if there are changes we cannot account >> for. Using KDiff also makes things easier, even >> when dealing with formatting changes. >> >> In Emacs, it's also easy to go through every set of >> changes, do an interactive-search for 1st >> entry of each set, and see if the 2nd entry is >> highlighted similarly. Meaning, if it is >> highlighted similarly, the set of changes is bogus >> (formatting only). >> >> In general, we should submit patches that are >> intentional, ie just the intended changes only. We >> should not submit patches that contain unintended >> changes that have extra unintended footprints. >> >> Jonathon >> >> David E. Jones wrote: >>> Moving this back to the mailing list... >>> >>> >>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: >>> >>>> David E. Jones wrote: >>>>> When reviewing a patch lines with formatting >> changes only are >>>>> EXTREMELY time consuming, and the patch >> attached that issue is a >>>>> good example of a painful one. For each of >> those line you have to >>>>> stare at it looking at every character trying >> to figure out what the >>>>> point of the bloody change was, or to make sure >> that the change is >>>>> "invisible"... >>>> That really puzzles me. You keep mentioning >> formatting changes when I >>>> don't see any. I didn't make any formatting >> changes when modifying the >>>> files. Even now when I look at the patch in Jira, >> it shows only the >>>> lines I changed in the file. >>>> >>>> *shrug* >>> As others may have the same question I'll answer >> it on the mailing list. >>> Below is the first section from the >> framework_v2.patch file on the >>> [https://issues.apache.org/jira/browse/OFBIZ-605] >> issue. >>> Each change is marked with a "-" for a line >> removed or a "+" for a line >>> added. >>> >>> First Set: formatting, or "invisible" change >>> >>> Second Set: add comment (not necessary, BTW as it >> describes something >>> that no longer exists; if people want to see old >> stuff they can look at >>> the SVN history); remove tabstyles.css link tag >>> >>> Third Set: formatting, or "invisible" change >>> >>> Of all of these changes, only the "remove >> tabstyles.css link tag" was >>> actually intended and necessary, but getting to >> this fact when reviewing >>> the changes takes some time... this making it more >> difficult to review, >>> commit, etc. >>> >>> People tend to slip things into patches >> accidentally all the time. I'm >>> tempted to begun the voting process for a new >> policy that says that if >>> there is anything in the patch file not described >> in the summary of the >>> patch, then it will be rejected... >>> >>> -David >>> >>> >>> ======================== >>> Index: common/webcommon/includes/header.ftl >>> > =================================================================== >>> --- common/webcommon/includes/header.ftl >> (revision 494159) >>> +++ common/webcommon/includes/header.ftl >> (working copy) >>> @@ -27,7 +27,7 @@ >>> <head> >>> <meta http-equiv="Content-Type" >> content="text/html; charset=UTF-8"/> >>> <title>${layoutSettings.companyName}: <#if >>> > (page.titleProperty)?has_content>${uiLabelMap[page.titleProperty]}<#else>${(page.title)?if_exists}</#if></title> >>> - <link rel="shortcut icon" >>> > href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" >> /> >>> + <link rel="shortcut icon" >>> > href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" >> /> >>> <script language="javascript" >>> > src="<@ofbizContentUrl>/images/calendar1.js</@ofbizContentUrl>" >>> type="text/javascript"></script> >>> <script language="javascript" >>> > src="<@ofbizContentUrl>/images/selectall.js</@ofbizContentUrl>" >>> type="text/javascript"></script> >>> <script language="javascript" >>> > src="<@ofbizContentUrl>/images/fieldlookup.js</@ofbizContentUrl>" >>> type="text/javascript"></script> >>> @@ -37,8 +37,8 @@ >>> <link rel="stylesheet" >>> > href="<@ofbizContentUrl>${styleSheet}</@ofbizContentUrl>" >> type="text/css"/> >>> </#list> >>> <#else> >>> + <#-- tabstyles.css has been moved to >> maincss.css --> >>> <link rel="stylesheet" >>> > href="<@ofbizContentUrl>/images/maincss.css</@ofbizContentUrl>" >>> type="text/css"/> >>> - <link rel="stylesheet" >>> > href="<@ofbizContentUrl>/images/tabstyles.css</@ofbizContentUrl>" >>> type="text/css"/> >>> </#if> >>> ${layoutSettings.extraHead?if_exists} >>> </head> >>> @@ -51,7 +51,7 @@ >>> <tr> >>> <#if >> layoutSettings.headerImageUrl?exists> >>> <td align="left" width="1%"><img >>> alt="${layoutSettings.companyName}" >>> > src="<@ofbizContentUrl>${layoutSettings.headerImageUrl}</@ofbizContentUrl>"/></td> >>> - </#if> >>> + </#if> >>> <td align="right" width="1%" >> nowrap="nowrap" <#if > layoutSettings.headerRightBackgroundUrl?has_content>background="${layoutSettings.headerRightBackgroundUrl}"</#if>> >>> <div class="insideHeaderText"> >>> <#if person?has_content> >>> ====================== >>> >> > > |
Yes, we want more people, but I don't think anyone wants indiscriminate changes going into SVN! I hate surprises when I check out as much as the next guy, probably more than the next guy in many cases. Thinking about the next guy is the real key here. You may want to get your patches in ASAP, but if your patch breaks existing code (for example), then that needs to be fixed before the commit is done (either by the committer, the contributor, or an interested third party). So, yeah, that slows things down and is inconvenient, but keep in mind that a large portion of patches that come into OFBiz break existing functionality. This seems to happen around once a week or so, at least. It's great that people want to contribute, but in or to contribute to something as large and complex as OFBiz a large amount of effort is necessary, and anyone that wants to help out will err on the side of extra effort, caution and review, and consideration of more general requirements and designs rather just one's own requirements. -David On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov wrote: > Heh. True. I definitely want MORE people involved in OFBiz. > > But since I'm not a committer, I'd rather make things easier for > the committers. I have no control over how easy or difficult it is > to handle patches with "extra unintended footprints". > > If I were a committer, I would try to automatically filter out > formatting changes in my audit, and then INCLUDE the formatting > changes. After all, there's no harm removing some extra spaces at > the end of lines, part of clean up. > > We often try to make things easier for the person who is doing a > task that we have no control over. Eg, I'd keep my mouth really > wide open for my dentist just so his vision is 20/20, no arguments > from me; I could afford to be slack about this "mouth wide-open > policy" if I were able to do the dentistry myself. > > But you're certainly right that it'll exclude some people, > especially folks who use editors that do not give very much control > to users. > > Jonathon > > Chris Howe wrote: >> I don't know that rejection policies are very >> community friendly. Treating SVN code changes like >> the keeper of the Bridge of Death (Monty Python >> Reference, smile) may find less people willing to do >> in this do-ocracy. Many of us rather like what's left >> of our anarco-sydicalist commune (oh look, there's >> another :-) ). >> --- Jonathon -- Improov <[hidden email]> wrote: >>> David, >>> >>> I agree with the rejection policy. >>> >>> One suggestion on procedure to take when >>> self-reviewing a patch before submitting it. Look at >>> the diff to see if there are changes we cannot account >>> for. Using KDiff also makes things easier, even when dealing with >>> formatting changes. >>> >>> In Emacs, it's also easy to go through every set of >>> changes, do an interactive-search for 1st entry of each set, and >>> see if the 2nd entry is >>> highlighted similarly. Meaning, if it is highlighted similarly, >>> the set of changes is bogus >>> (formatting only). >>> >>> In general, we should submit patches that are >>> intentional, ie just the intended changes only. We should not >>> submit patches that contain unintended >>> changes that have extra unintended footprints. >>> >>> Jonathon >>> >>> David E. Jones wrote: >>>> Moving this back to the mailing list... >>>> >>>> >>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: >>>> >>>>> David E. Jones wrote: >>>>>> When reviewing a patch lines with formatting >>> changes only are >>>>>> EXTREMELY time consuming, and the patch >>> attached that issue is a >>>>>> good example of a painful one. For each of >>> those line you have to >>>>>> stare at it looking at every character trying >>> to figure out what the >>>>>> point of the bloody change was, or to make sure >>> that the change is >>>>>> "invisible"... >>>>> That really puzzles me. You keep mentioning >>> formatting changes when I >>>>> don't see any. I didn't make any formatting >>> changes when modifying the >>>>> files. Even now when I look at the patch in Jira, >>> it shows only the >>>>> lines I changed in the file. >>>>> >>>>> *shrug* >>>> As others may have the same question I'll answer >>> it on the mailing list. >>>> Below is the first section from the >>> framework_v2.patch file on the >>>> [https://issues.apache.org/jira/browse/OFBIZ-605] >>> issue. >>>> Each change is marked with a "-" for a line >>> removed or a "+" for a line >>>> added. >>>> >>>> First Set: formatting, or "invisible" change >>>> >>>> Second Set: add comment (not necessary, BTW as it >>> describes something >>>> that no longer exists; if people want to see old >>> stuff they can look at >>>> the SVN history); remove tabstyles.css link tag >>>> >>>> Third Set: formatting, or "invisible" change >>>> >>>> Of all of these changes, only the "remove >>> tabstyles.css link tag" was >>>> actually intended and necessary, but getting to >>> this fact when reviewing >>>> the changes takes some time... this making it more >>> difficult to review, >>>> commit, etc. >>>> >>>> People tend to slip things into patches >>> accidentally all the time. I'm >>>> tempted to begun the voting process for a new >>> policy that says that if >>>> there is anything in the patch file not described >>> in the summary of the >>>> patch, then it will be rejected... >>>> >>>> -David >>>> >>>> >>>> ======================== >>>> Index: common/webcommon/includes/header.ftl >>>> >> =================================================================== >>>> --- common/webcommon/includes/header.ftl >>> (revision 494159) >>>> +++ common/webcommon/includes/header.ftl >>> (working copy) >>>> @@ -27,7 +27,7 @@ >>>> <head> >>>> <meta http-equiv="Content-Type" >>> content="text/html; charset=UTF-8"/> >>>> <title>${layoutSettings.companyName}: <#if >> (page.titleProperty)?has_content>${uiLabelMap[page.titleProperty]} >> <#else>${(page.title)?if_exists}</#if></title> >>>> - <link rel="shortcut icon" >> href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" >>> /> >>>> + <link rel="shortcut icon" >> href="<@ofbizContentUrl>/images/ofbiz.ico</@ofbizContentUrl>" >>> /> >>>> <script language="javascript" >> src="<@ofbizContentUrl>/images/calendar1.js</@ofbizContentUrl>" >>>> type="text/javascript"></script> >>>> <script language="javascript" >> src="<@ofbizContentUrl>/images/selectall.js</@ofbizContentUrl>" >>>> type="text/javascript"></script> >>>> <script language="javascript" >> src="<@ofbizContentUrl>/images/fieldlookup.js</@ofbizContentUrl>" >>>> type="text/javascript"></script> >>>> @@ -37,8 +37,8 @@ >>>> <link rel="stylesheet" >> href="<@ofbizContentUrl>${styleSheet}</@ofbizContentUrl>" >>> type="text/css"/> >>>> </#list> >>>> <#else> >>>> + <#-- tabstyles.css has been moved to >>> maincss.css --> >>>> <link rel="stylesheet" >> href="<@ofbizContentUrl>/images/maincss.css</@ofbizContentUrl>" >>>> type="text/css"/> >>>> - <link rel="stylesheet" >> href="<@ofbizContentUrl>/images/tabstyles.css</@ofbizContentUrl>" >>>> type="text/css"/> >>>> </#if> >>>> ${layoutSettings.extraHead?if_exists} >>>> </head> >>>> @@ -51,7 +51,7 @@ >>>> <tr> >>>> <#if >>> layoutSettings.headerImageUrl?exists> >>>> <td align="left" width="1%"><img alt="$ >>>> {layoutSettings.companyName}" >> src="<@ofbizContentUrl>${layoutSettings.headerImageUrl}</ >> @ofbizContentUrl>"/></td> >>>> - </#if> >>>> + </#if> >>>> <td align="right" width="1%" >>> nowrap="nowrap" <#if >> layoutSettings.headerRightBackgroundUrl?has_content>background="$ >> {layoutSettings.headerRightBackgroundUrl}"</#if>> >>>> <div class="insideHeaderText"> >>>> <#if person?has_content> >>>> ====================== >>>> >>> > smime.p7s (3K) Download Attachment |
I agree. I think it's better that we strongly
encourage certain practices (as we are doing now) and bring people to notice when those practices could be improved, but rejection policies put your _means perspective ahead of your _ends. Contributions may be easier to review, but I can gaurantee you with rejection policies, you will then have less of it to review and thereby less solutions making it back into the project. --- "David E. Jones" <[hidden email]> wrote: > > Yes, we want more people, but I don't think anyone > wants > indiscriminate changes going into SVN! I hate > surprises when I check > out as much as the next guy, probably more than the > next guy in many > cases. > > Thinking about the next guy is the real key here. > You may want to get > your patches in ASAP, but if your patch breaks > existing code (for > example), then that needs to be fixed before the > commit is done > (either by the committer, the contributor, or an > interested third > party). > > So, yeah, that slows things down and is > inconvenient, but keep in > mind that a large portion of patches that come into > OFBiz break > existing functionality. This seems to happen around > once a week or > so, at least. > > It's great that people want to contribute, but in or > to contribute to > something as large and complex as OFBiz a large > amount of effort is > necessary, and anyone that wants to help out will > err on the side of > extra effort, caution and review, and consideration > of more general > requirements and designs rather just one's own > requirements. > > -David > > > > On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov > wrote: > > > Heh. True. I definitely want MORE people involved > in OFBiz. > > > > But since I'm not a committer, I'd rather make > things easier for > > the committers. I have no control over how easy or > difficult it is > > to handle patches with "extra unintended > footprints". > > > > If I were a committer, I would try to > automatically filter out > > formatting changes in my audit, and then INCLUDE > the formatting > > changes. After all, there's no harm removing some > extra spaces at > > the end of lines, part of clean up. > > > > We often try to make things easier for the person > who is doing a > > task that we have no control over. Eg, I'd keep my > mouth really > > wide open for my dentist just so his vision is > 20/20, no arguments > > from me; I could afford to be slack about this > "mouth wide-open > > policy" if I were able to do the dentistry myself. > > > > But you're certainly right that it'll exclude some > people, > > especially folks who use editors that do not give > very much control > > to users. > > > > Jonathon > > > > Chris Howe wrote: > >> I don't know that rejection policies are very > >> community friendly. Treating SVN code changes > like > >> the keeper of the Bridge of Death (Monty Python > >> Reference, smile) may find less people willing to > do > >> in this do-ocracy. Many of us rather like what's > left > >> of our anarco-sydicalist commune (oh look, > there's > >> another :-) ). > >> --- Jonathon -- Improov <[hidden email]> wrote: > >>> David, > >>> > >>> I agree with the rejection policy. > >>> > >>> One suggestion on procedure to take when > >>> self-reviewing a patch before submitting it. > Look at > >>> the diff to see if there are changes we cannot > account > >>> for. Using KDiff also makes things easier, even > when dealing with > >>> formatting changes. > >>> > >>> In Emacs, it's also easy to go through every set > of > >>> changes, do an interactive-search for 1st entry > of each set, and > >>> see if the 2nd entry is > >>> highlighted similarly. Meaning, if it is > highlighted similarly, > >>> the set of changes is bogus > >>> (formatting only). > >>> > >>> In general, we should submit patches that are > >>> intentional, ie just the intended changes only. > We should not > >>> submit patches that contain unintended > >>> changes that have extra unintended footprints. > >>> > >>> Jonathon > >>> > >>> David E. Jones wrote: > >>>> Moving this back to the mailing list... > >>>> > >>>> > >>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > >>>> > >>>>> David E. Jones wrote: > >>>>>> When reviewing a patch lines with formatting > >>> changes only are > >>>>>> EXTREMELY time consuming, and the patch > >>> attached that issue is a > >>>>>> good example of a painful one. For each of > >>> those line you have to > >>>>>> stare at it looking at every character trying > >>> to figure out what the > >>>>>> point of the bloody change was, or to make > sure > >>> that the change is > >>>>>> "invisible"... > >>>>> That really puzzles me. You keep mentioning > >>> formatting changes when I > >>>>> don't see any. I didn't make any formatting > >>> changes when modifying the > >>>>> files. Even now when I look at the patch in > Jira, > >>> it shows only the > >>>>> lines I changed in the file. > >>>>> > >>>>> *shrug* > >>>> As others may have the same question I'll > answer > >>> it on the mailing list. > >>>> Below is the first section from the > >>> framework_v2.patch file on the > >>>> > [https://issues.apache.org/jira/browse/OFBIZ-605] > >>> issue. > >>>> Each change is marked with a "-" for a line > >>> removed or a "+" for a line > >>>> added. > >>>> > >>>> First Set: formatting, or "invisible" change > >>>> > >>>> Second Set: add comment (not necessary, BTW as > it > >>> describes something > >>>> that no longer exists; if people want to see > old > >>> stuff they can look at > >>>> the SVN history); remove tabstyles.css link tag > >>>> > >>>> Third Set: formatting, or "invisible" change > >>>> > >>>> Of all of these changes, only the "remove > >>> tabstyles.css link tag" was > >>>> actually intended and necessary, but getting to > >>> this fact when reviewing > >>>> the changes takes some time... this making it > more > >>> difficult to review, > >>>> commit, etc. > >>>> > >>>> People tend to slip things into patches > >>> accidentally all the time. I'm > >>>> tempted to begun the voting process for a new > >>> policy that says that if > >>>> there is anything in the patch file not > described > >>> in the summary of the > >>>> patch, then it will be rejected... > >>>> > >>>> -David > >>>> > >>>> > >>>> ======================== > >>>> Index: common/webcommon/includes/header.ftl > |
Ummm... what do you think when you think of a rejection policy? We already have patch rejection policies when problems are found... -David On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > I agree. I think it's better that we strongly > encourage certain practices (as we are doing now) and > bring people to notice when those practices could be > improved, but rejection policies put your _means > perspective ahead of your _ends. Contributions may be > easier to review, but I can gaurantee you with > rejection policies, you will then have less of it to > review and thereby less solutions making it back into > the project. > > --- "David E. Jones" <[hidden email]> wrote: > >> >> Yes, we want more people, but I don't think anyone >> wants >> indiscriminate changes going into SVN! I hate >> surprises when I check >> out as much as the next guy, probably more than the >> next guy in many >> cases. >> >> Thinking about the next guy is the real key here. >> You may want to get >> your patches in ASAP, but if your patch breaks >> existing code (for >> example), then that needs to be fixed before the >> commit is done >> (either by the committer, the contributor, or an >> interested third >> party). >> >> So, yeah, that slows things down and is >> inconvenient, but keep in >> mind that a large portion of patches that come into >> OFBiz break >> existing functionality. This seems to happen around >> once a week or >> so, at least. >> >> It's great that people want to contribute, but in or >> to contribute to >> something as large and complex as OFBiz a large >> amount of effort is >> necessary, and anyone that wants to help out will >> err on the side of >> extra effort, caution and review, and consideration >> of more general >> requirements and designs rather just one's own >> requirements. >> >> -David >> >> >> >> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov >> wrote: >> >>> Heh. True. I definitely want MORE people involved >> in OFBiz. >>> >>> But since I'm not a committer, I'd rather make >> things easier for >>> the committers. I have no control over how easy or >> difficult it is >>> to handle patches with "extra unintended >> footprints". >>> >>> If I were a committer, I would try to >> automatically filter out >>> formatting changes in my audit, and then INCLUDE >> the formatting >>> changes. After all, there's no harm removing some >> extra spaces at >>> the end of lines, part of clean up. >>> >>> We often try to make things easier for the person >> who is doing a >>> task that we have no control over. Eg, I'd keep my >> mouth really >>> wide open for my dentist just so his vision is >> 20/20, no arguments >>> from me; I could afford to be slack about this >> "mouth wide-open >>> policy" if I were able to do the dentistry myself. >>> >>> But you're certainly right that it'll exclude some >> people, >>> especially folks who use editors that do not give >> very much control >>> to users. >>> >>> Jonathon >>> >>> Chris Howe wrote: >>>> I don't know that rejection policies are very >>>> community friendly. Treating SVN code changes >> like >>>> the keeper of the Bridge of Death (Monty Python >>>> Reference, smile) may find less people willing to >> do >>>> in this do-ocracy. Many of us rather like what's >> left >>>> of our anarco-sydicalist commune (oh look, >> there's >>>> another :-) ). >>>> --- Jonathon -- Improov <[hidden email]> wrote: >>>>> David, >>>>> >>>>> I agree with the rejection policy. >>>>> >>>>> One suggestion on procedure to take when >>>>> self-reviewing a patch before submitting it. >> Look at >>>>> the diff to see if there are changes we cannot >> account >>>>> for. Using KDiff also makes things easier, even >> when dealing with >>>>> formatting changes. >>>>> >>>>> In Emacs, it's also easy to go through every set >> of >>>>> changes, do an interactive-search for 1st entry >> of each set, and >>>>> see if the 2nd entry is >>>>> highlighted similarly. Meaning, if it is >> highlighted similarly, >>>>> the set of changes is bogus >>>>> (formatting only). >>>>> >>>>> In general, we should submit patches that are >>>>> intentional, ie just the intended changes only. >> We should not >>>>> submit patches that contain unintended >>>>> changes that have extra unintended footprints. >>>>> >>>>> Jonathon >>>>> >>>>> David E. Jones wrote: >>>>>> Moving this back to the mailing list... >>>>>> >>>>>> >>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: >>>>>> >>>>>>> David E. Jones wrote: >>>>>>>> When reviewing a patch lines with formatting >>>>> changes only are >>>>>>>> EXTREMELY time consuming, and the patch >>>>> attached that issue is a >>>>>>>> good example of a painful one. For each of >>>>> those line you have to >>>>>>>> stare at it looking at every character trying >>>>> to figure out what the >>>>>>>> point of the bloody change was, or to make >> sure >>>>> that the change is >>>>>>>> "invisible"... >>>>>>> That really puzzles me. You keep mentioning >>>>> formatting changes when I >>>>>>> don't see any. I didn't make any formatting >>>>> changes when modifying the >>>>>>> files. Even now when I look at the patch in >> Jira, >>>>> it shows only the >>>>>>> lines I changed in the file. >>>>>>> >>>>>>> *shrug* >>>>>> As others may have the same question I'll >> answer >>>>> it on the mailing list. >>>>>> Below is the first section from the >>>>> framework_v2.patch file on the >>>>>> >> [https://issues.apache.org/jira/browse/OFBIZ-605] >>>>> issue. >>>>>> Each change is marked with a "-" for a line >>>>> removed or a "+" for a line >>>>>> added. >>>>>> >>>>>> First Set: formatting, or "invisible" change >>>>>> >>>>>> Second Set: add comment (not necessary, BTW as >> it >>>>> describes something >>>>>> that no longer exists; if people want to see >> old >>>>> stuff they can look at >>>>>> the SVN history); remove tabstyles.css link tag >>>>>> >>>>>> Third Set: formatting, or "invisible" change >>>>>> >>>>>> Of all of these changes, only the "remove >>>>> tabstyles.css link tag" was >>>>>> actually intended and necessary, but getting to >>>>> this fact when reviewing >>>>>> the changes takes some time... this making it >> more >>>>> difficult to review, >>>>>> commit, etc. >>>>>> >>>>>> People tend to slip things into patches >>>>> accidentally all the time. I'm >>>>>> tempted to begun the voting process for a new >>>>> policy that says that if >>>>>> there is anything in the patch file not >> described >>>>> in the summary of the >>>>>> patch, then it will be rejected... >>>>>> >>>>>> -David >>>>>> >>>>>> >>>>>> ======================== >>>>>> Index: common/webcommon/includes/header.ftl >> > === message truncated === > smime.p7s (3K) Download Attachment |
I´m giving my opinion, because it seems obvious to me that if you
reject a patch, the contributor will correct it in the 99% of the times...and will learn, so the next time he probably won´t commit the same mistakes. This way we reduce the effort to the few commiters increasing the chances for them to commit other patches.... Stronger policies: +1 2007/1/16, David E. Jones <[hidden email]>: > > Ummm... what do you think when you think of a rejection policy? We > already have patch rejection policies when problems are found... > > -David > > > On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > > > I agree. I think it's better that we strongly > > encourage certain practices (as we are doing now) and > > bring people to notice when those practices could be > > improved, but rejection policies put your _means > > perspective ahead of your _ends. Contributions may be > > easier to review, but I can gaurantee you with > > rejection policies, you will then have less of it to > > review and thereby less solutions making it back into > > the project. > > > > --- "David E. Jones" <[hidden email]> wrote: > > > >> > >> Yes, we want more people, but I don't think anyone > >> wants > >> indiscriminate changes going into SVN! I hate > >> surprises when I check > >> out as much as the next guy, probably more than the > >> next guy in many > >> cases. > >> > >> Thinking about the next guy is the real key here. > >> You may want to get > >> your patches in ASAP, but if your patch breaks > >> existing code (for > >> example), then that needs to be fixed before the > >> commit is done > >> (either by the committer, the contributor, or an > >> interested third > >> party). > >> > >> So, yeah, that slows things down and is > >> inconvenient, but keep in > >> mind that a large portion of patches that come into > >> OFBiz break > >> existing functionality. This seems to happen around > >> once a week or > >> so, at least. > >> > >> It's great that people want to contribute, but in or > >> to contribute to > >> something as large and complex as OFBiz a large > >> amount of effort is > >> necessary, and anyone that wants to help out will > >> err on the side of > >> extra effort, caution and review, and consideration > >> of more general > >> requirements and designs rather just one's own > >> requirements. > >> > >> -David > >> > >> > >> > >> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov > >> wrote: > >> > >>> Heh. True. I definitely want MORE people involved > >> in OFBiz. > >>> > >>> But since I'm not a committer, I'd rather make > >> things easier for > >>> the committers. I have no control over how easy or > >> difficult it is > >>> to handle patches with "extra unintended > >> footprints". > >>> > >>> If I were a committer, I would try to > >> automatically filter out > >>> formatting changes in my audit, and then INCLUDE > >> the formatting > >>> changes. After all, there's no harm removing some > >> extra spaces at > >>> the end of lines, part of clean up. > >>> > >>> We often try to make things easier for the person > >> who is doing a > >>> task that we have no control over. Eg, I'd keep my > >> mouth really > >>> wide open for my dentist just so his vision is > >> 20/20, no arguments > >>> from me; I could afford to be slack about this > >> "mouth wide-open > >>> policy" if I were able to do the dentistry myself. > >>> > >>> But you're certainly right that it'll exclude some > >> people, > >>> especially folks who use editors that do not give > >> very much control > >>> to users. > >>> > >>> Jonathon > >>> > >>> Chris Howe wrote: > >>>> I don't know that rejection policies are very > >>>> community friendly. Treating SVN code changes > >> like > >>>> the keeper of the Bridge of Death (Monty Python > >>>> Reference, smile) may find less people willing to > >> do > >>>> in this do-ocracy. Many of us rather like what's > >> left > >>>> of our anarco-sydicalist commune (oh look, > >> there's > >>>> another :-) ). > >>>> --- Jonathon -- Improov <[hidden email]> wrote: > >>>>> David, > >>>>> > >>>>> I agree with the rejection policy. > >>>>> > >>>>> One suggestion on procedure to take when > >>>>> self-reviewing a patch before submitting it. > >> Look at > >>>>> the diff to see if there are changes we cannot > >> account > >>>>> for. Using KDiff also makes things easier, even > >> when dealing with > >>>>> formatting changes. > >>>>> > >>>>> In Emacs, it's also easy to go through every set > >> of > >>>>> changes, do an interactive-search for 1st entry > >> of each set, and > >>>>> see if the 2nd entry is > >>>>> highlighted similarly. Meaning, if it is > >> highlighted similarly, > >>>>> the set of changes is bogus > >>>>> (formatting only). > >>>>> > >>>>> In general, we should submit patches that are > >>>>> intentional, ie just the intended changes only. > >> We should not > >>>>> submit patches that contain unintended > >>>>> changes that have extra unintended footprints. > >>>>> > >>>>> Jonathon > >>>>> > >>>>> David E. Jones wrote: > >>>>>> Moving this back to the mailing list... > >>>>>> > >>>>>> > >>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > >>>>>> > >>>>>>> David E. Jones wrote: > >>>>>>>> When reviewing a patch lines with formatting > >>>>> changes only are > >>>>>>>> EXTREMELY time consuming, and the patch > >>>>> attached that issue is a > >>>>>>>> good example of a painful one. For each of > >>>>> those line you have to > >>>>>>>> stare at it looking at every character trying > >>>>> to figure out what the > >>>>>>>> point of the bloody change was, or to make > >> sure > >>>>> that the change is > >>>>>>>> "invisible"... > >>>>>>> That really puzzles me. You keep mentioning > >>>>> formatting changes when I > >>>>>>> don't see any. I didn't make any formatting > >>>>> changes when modifying the > >>>>>>> files. Even now when I look at the patch in > >> Jira, > >>>>> it shows only the > >>>>>>> lines I changed in the file. > >>>>>>> > >>>>>>> *shrug* > >>>>>> As others may have the same question I'll > >> answer > >>>>> it on the mailing list. > >>>>>> Below is the first section from the > >>>>> framework_v2.patch file on the > >>>>>> > >> [https://issues.apache.org/jira/browse/OFBIZ-605] > >>>>> issue. > >>>>>> Each change is marked with a "-" for a line > >>>>> removed or a "+" for a line > >>>>>> added. > >>>>>> > >>>>>> First Set: formatting, or "invisible" change > >>>>>> > >>>>>> Second Set: add comment (not necessary, BTW as > >> it > >>>>> describes something > >>>>>> that no longer exists; if people want to see > >> old > >>>>> stuff they can look at > >>>>>> the SVN history); remove tabstyles.css link tag > >>>>>> > >>>>>> Third Set: formatting, or "invisible" change > >>>>>> > >>>>>> Of all of these changes, only the "remove > >>>>> tabstyles.css link tag" was > >>>>>> actually intended and necessary, but getting to > >>>>> this fact when reviewing > >>>>>> the changes takes some time... this making it > >> more > >>>>> difficult to review, > >>>>>> commit, etc. > >>>>>> > >>>>>> People tend to slip things into patches > >>>>> accidentally all the time. I'm > >>>>>> tempted to begun the voting process for a new > >>>>> policy that says that if > >>>>>> there is anything in the patch file not > >> described > >>>>> in the summary of the > >>>>>> patch, then it will be rejected... > >>>>>> > >>>>>> -David > >>>>>> > >>>>>> > >>>>>> ======================== > >>>>>> Index: common/webcommon/includes/header.ftl > >> > > === message truncated === > > > > > > -- Guido Amarilla |
In reply to this post by David E Jones
Being tempted to ask for a vote, insinuates that you
want to condone a practice whereby if you go to review a patch like in Adrian's case and it has superflous formatting changes, that you would delete it from JIRA in a "sorry kid, you're wasting my time" dismissal (email impressions added for levity). Anything less is what is currently going on and wouldn't need a vote. People aren't tempted to vote on the status quo. --- "David E. Jones" <[hidden email]> wrote: > > Ummm... what do you think when you think of a > rejection policy? We > already have patch rejection policies when problems > are found... > > -David > > > On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > > > I agree. I think it's better that we strongly > > encourage certain practices (as we are doing now) > and > > bring people to notice when those practices could > be > > improved, but rejection policies put your _means > > perspective ahead of your _ends. Contributions > may be > > easier to review, but I can gaurantee you with > > rejection policies, you will then have less of it > to > > review and thereby less solutions making it back > into > > the project. > > > > --- "David E. Jones" <[hidden email]> > wrote: > > > >> > >> Yes, we want more people, but I don't think > anyone > >> wants > >> indiscriminate changes going into SVN! I hate > >> surprises when I check > >> out as much as the next guy, probably more than > the > >> next guy in many > >> cases. > >> > >> Thinking about the next guy is the real key here. > >> You may want to get > >> your patches in ASAP, but if your patch breaks > >> existing code (for > >> example), then that needs to be fixed before the > >> commit is done > >> (either by the committer, the contributor, or an > >> interested third > >> party). > >> > >> So, yeah, that slows things down and is > >> inconvenient, but keep in > >> mind that a large portion of patches that come > into > >> OFBiz break > >> existing functionality. This seems to happen > around > >> once a week or > >> so, at least. > >> > >> It's great that people want to contribute, but in > or > >> to contribute to > >> something as large and complex as OFBiz a large > >> amount of effort is > >> necessary, and anyone that wants to help out will > >> err on the side of > >> extra effort, caution and review, and > consideration > >> of more general > >> requirements and designs rather just one's own > >> requirements. > >> > >> -David > >> > >> > >> > >> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov > >> wrote: > >> > >>> Heh. True. I definitely want MORE people > involved > >> in OFBiz. > >>> > >>> But since I'm not a committer, I'd rather make > >> things easier for > >>> the committers. I have no control over how easy > or > >> difficult it is > >>> to handle patches with "extra unintended > >> footprints". > >>> > >>> If I were a committer, I would try to > >> automatically filter out > >>> formatting changes in my audit, and then INCLUDE > >> the formatting > >>> changes. After all, there's no harm removing > some > >> extra spaces at > >>> the end of lines, part of clean up. > >>> > >>> We often try to make things easier for the > person > >> who is doing a > >>> task that we have no control over. Eg, I'd keep > my > >> mouth really > >>> wide open for my dentist just so his vision is > >> 20/20, no arguments > >>> from me; I could afford to be slack about this > >> "mouth wide-open > >>> policy" if I were able to do the dentistry > myself. > >>> > >>> But you're certainly right that it'll exclude > some > >> people, > >>> especially folks who use editors that do not > give > >> very much control > >>> to users. > >>> > >>> Jonathon > >>> > >>> Chris Howe wrote: > >>>> I don't know that rejection policies are very > >>>> community friendly. Treating SVN code changes > >> like > >>>> the keeper of the Bridge of Death (Monty Python > >>>> Reference, smile) may find less people willing > to > >> do > >>>> in this do-ocracy. Many of us rather like > what's > >> left > >>>> of our anarco-sydicalist commune (oh look, > >> there's > >>>> another :-) ). > >>>> --- Jonathon -- Improov <[hidden email]> > wrote: > >>>>> David, > >>>>> > >>>>> I agree with the rejection policy. > >>>>> > >>>>> One suggestion on procedure to take when > >>>>> self-reviewing a patch before submitting it. > >> Look at > >>>>> the diff to see if there are changes we cannot > >> account > >>>>> for. Using KDiff also makes things easier, > even > >> when dealing with > >>>>> formatting changes. > >>>>> > >>>>> In Emacs, it's also easy to go through every > set > >> of > >>>>> changes, do an interactive-search for 1st > entry > >> of each set, and > >>>>> see if the 2nd entry is > >>>>> highlighted similarly. Meaning, if it is > >> highlighted similarly, > >>>>> the set of changes is bogus > >>>>> (formatting only). > >>>>> > >>>>> In general, we should submit patches that are > >>>>> intentional, ie just the intended changes > only. > >> We should not > >>>>> submit patches that contain unintended > >>>>> changes that have extra unintended footprints. > >>>>> > >>>>> Jonathon > >>>>> > >>>>> David E. Jones wrote: > >>>>>> Moving this back to the mailing list... > >>>>>> > >>>>>> > >>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum > wrote: > >>>>>> > >>>>>>> David E. Jones wrote: > >>>>>>>> When reviewing a patch lines with > formatting > >>>>> changes only are > >>>>>>>> EXTREMELY time consuming, and the patch > >>>>> attached that issue is a > >>>>>>>> good example of a painful one. For each of > >>>>> those line you have to > >>>>>>>> stare at it looking at every character > trying > >>>>> to figure out what the > >>>>>>>> point of the bloody change was, or to make > >> sure > >>>>> that the change is > >>>>>>>> "invisible"... > >>>>>>> That really puzzles me. You keep mentioning > >>>>> formatting changes when I > >>>>>>> don't see any. I didn't make any formatting > >>>>> changes when modifying the > |
You have quite an imagination. -David On Jan 15, 2007, at 10:01 PM, Chris Howe wrote: > Being tempted to ask for a vote, insinuates that you > want to condone a practice whereby if you go to review > a patch like in Adrian's case and it has superflous > formatting changes, that you would delete it from JIRA > in a "sorry kid, you're wasting my time" dismissal > (email impressions added for levity). Anything less > is what is currently going on and wouldn't need a > vote. People aren't tempted to vote on the status > quo. > > --- "David E. Jones" <[hidden email]> wrote: > >> >> Ummm... what do you think when you think of a >> rejection policy? We >> already have patch rejection policies when problems >> are found... >> >> -David >> >> >> On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: >> >>> I agree. I think it's better that we strongly >>> encourage certain practices (as we are doing now) >> and >>> bring people to notice when those practices could >> be >>> improved, but rejection policies put your _means >>> perspective ahead of your _ends. Contributions >> may be >>> easier to review, but I can gaurantee you with >>> rejection policies, you will then have less of it >> to >>> review and thereby less solutions making it back >> into >>> the project. >>> >>> --- "David E. Jones" <[hidden email]> >> wrote: >>> >>>> >>>> Yes, we want more people, but I don't think >> anyone >>>> wants >>>> indiscriminate changes going into SVN! I hate >>>> surprises when I check >>>> out as much as the next guy, probably more than >> the >>>> next guy in many >>>> cases. >>>> >>>> Thinking about the next guy is the real key here. >>>> You may want to get >>>> your patches in ASAP, but if your patch breaks >>>> existing code (for >>>> example), then that needs to be fixed before the >>>> commit is done >>>> (either by the committer, the contributor, or an >>>> interested third >>>> party). >>>> >>>> So, yeah, that slows things down and is >>>> inconvenient, but keep in >>>> mind that a large portion of patches that come >> into >>>> OFBiz break >>>> existing functionality. This seems to happen >> around >>>> once a week or >>>> so, at least. >>>> >>>> It's great that people want to contribute, but in >> or >>>> to contribute to >>>> something as large and complex as OFBiz a large >>>> amount of effort is >>>> necessary, and anyone that wants to help out will >>>> err on the side of >>>> extra effort, caution and review, and >> consideration >>>> of more general >>>> requirements and designs rather just one's own >>>> requirements. >>>> >>>> -David >>>> >>>> >>>> >>>> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov >>>> wrote: >>>> >>>>> Heh. True. I definitely want MORE people >> involved >>>> in OFBiz. >>>>> >>>>> But since I'm not a committer, I'd rather make >>>> things easier for >>>>> the committers. I have no control over how easy >> or >>>> difficult it is >>>>> to handle patches with "extra unintended >>>> footprints". >>>>> >>>>> If I were a committer, I would try to >>>> automatically filter out >>>>> formatting changes in my audit, and then INCLUDE >>>> the formatting >>>>> changes. After all, there's no harm removing >> some >>>> extra spaces at >>>>> the end of lines, part of clean up. >>>>> >>>>> We often try to make things easier for the >> person >>>> who is doing a >>>>> task that we have no control over. Eg, I'd keep >> my >>>> mouth really >>>>> wide open for my dentist just so his vision is >>>> 20/20, no arguments >>>>> from me; I could afford to be slack about this >>>> "mouth wide-open >>>>> policy" if I were able to do the dentistry >> myself. >>>>> >>>>> But you're certainly right that it'll exclude >> some >>>> people, >>>>> especially folks who use editors that do not >> give >>>> very much control >>>>> to users. >>>>> >>>>> Jonathon >>>>> >>>>> Chris Howe wrote: >>>>>> I don't know that rejection policies are very >>>>>> community friendly. Treating SVN code changes >>>> like >>>>>> the keeper of the Bridge of Death (Monty Python >>>>>> Reference, smile) may find less people willing >> to >>>> do >>>>>> in this do-ocracy. Many of us rather like >> what's >>>> left >>>>>> of our anarco-sydicalist commune (oh look, >>>> there's >>>>>> another :-) ). >>>>>> --- Jonathon -- Improov <[hidden email]> >> wrote: >>>>>>> David, >>>>>>> >>>>>>> I agree with the rejection policy. >>>>>>> >>>>>>> One suggestion on procedure to take when >>>>>>> self-reviewing a patch before submitting it. >>>> Look at >>>>>>> the diff to see if there are changes we cannot >>>> account >>>>>>> for. Using KDiff also makes things easier, >> even >>>> when dealing with >>>>>>> formatting changes. >>>>>>> >>>>>>> In Emacs, it's also easy to go through every >> set >>>> of >>>>>>> changes, do an interactive-search for 1st >> entry >>>> of each set, and >>>>>>> see if the 2nd entry is >>>>>>> highlighted similarly. Meaning, if it is >>>> highlighted similarly, >>>>>>> the set of changes is bogus >>>>>>> (formatting only). >>>>>>> >>>>>>> In general, we should submit patches that are >>>>>>> intentional, ie just the intended changes >> only. >>>> We should not >>>>>>> submit patches that contain unintended >>>>>>> changes that have extra unintended footprints. >>>>>>> >>>>>>> Jonathon >>>>>>> >>>>>>> David E. Jones wrote: >>>>>>>> Moving this back to the mailing list... >>>>>>>> >>>>>>>> >>>>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum >> wrote: >>>>>>>> >>>>>>>>> David E. Jones wrote: >>>>>>>>>> When reviewing a patch lines with >> formatting >>>>>>> changes only are >>>>>>>>>> EXTREMELY time consuming, and the patch >>>>>>> attached that issue is a >>>>>>>>>> good example of a painful one. For each of >>>>>>> those line you have to >>>>>>>>>> stare at it looking at every character >> trying >>>>>>> to figure out what the >>>>>>>>>> point of the bloody change was, or to make >>>> sure >>>>>>> that the change is >>>>>>>>>> "invisible"... >>>>>>>>> That really puzzles me. You keep mentioning >>>>>>> formatting changes when I >>>>>>>>> don't see any. I didn't make any formatting >>>>>>> changes when modifying the >> > === message truncated === > smime.p7s (3K) Download Attachment |
Sorry, I don't know why that quote didn't hit me right
the first time. My apologies to W.C. Fields. Go away, kid, you bother me. I really butchered it. I mean _really :-) So, if that's not the policy and procedure you're looking to adopt, please elaborate on what you're tempted to propose. --- "David E. Jones" <[hidden email]> wrote: > > You have quite an imagination. > > -David > > > On Jan 15, 2007, at 10:01 PM, Chris Howe wrote: > > > Being tempted to ask for a vote, insinuates that > you > > want to condone a practice whereby if you go to > review > > a patch like in Adrian's case and it has > superflous > > formatting changes, that you would delete it from > JIRA > > in a "sorry kid, you're wasting my time" dismissal > > (email impressions added for levity). Anything > less > > is what is currently going on and wouldn't need a > > vote. People aren't tempted to vote on the status > > quo. > > > > --- "David E. Jones" <[hidden email]> > wrote: > > > >> > >> Ummm... what do you think when you think of a > >> rejection policy? We > >> already have patch rejection policies when > problems > >> are found... > >> > >> -David > >> > >> > >> On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > >> > >>> I agree. I think it's better that we strongly > >>> encourage certain practices (as we are doing > now) > >> and > >>> bring people to notice when those practices > could > >> be > >>> improved, but rejection policies put your _means > >>> perspective ahead of your _ends. Contributions > >> may be > >>> easier to review, but I can gaurantee you with > >>> rejection policies, you will then have less of > it > >> to > >>> review and thereby less solutions making it back > >> into > >>> the project. > >>> > >>> --- "David E. Jones" <[hidden email]> > >> wrote: > >>> > >>>> > >>>> Yes, we want more people, but I don't think > >> anyone > >>>> wants > >>>> indiscriminate changes going into SVN! I hate > >>>> surprises when I check > >>>> out as much as the next guy, probably more than > >> the > >>>> next guy in many > >>>> cases. > >>>> > >>>> Thinking about the next guy is the real key > here. > >>>> You may want to get > >>>> your patches in ASAP, but if your patch breaks > >>>> existing code (for > >>>> example), then that needs to be fixed before > the > >>>> commit is done > >>>> (either by the committer, the contributor, or > an > >>>> interested third > >>>> party). > >>>> > >>>> So, yeah, that slows things down and is > >>>> inconvenient, but keep in > >>>> mind that a large portion of patches that come > >> into > >>>> OFBiz break > >>>> existing functionality. This seems to happen > >> around > >>>> once a week or > >>>> so, at least. > >>>> > >>>> It's great that people want to contribute, but > in > >> or > >>>> to contribute to > >>>> something as large and complex as OFBiz a large > >>>> amount of effort is > >>>> necessary, and anyone that wants to help out > will > >>>> err on the side of > >>>> extra effort, caution and review, and > >> consideration > >>>> of more general > >>>> requirements and designs rather just one's own > >>>> requirements. > >>>> > >>>> -David > >>>> > >>>> > >>>> > >>>> On Jan 15, 2007, at 7:42 PM, Jonathon -- > Improov > >>>> wrote: > >>>> > >>>>> Heh. True. I definitely want MORE people > >> involved > >>>> in OFBiz. > >>>>> > >>>>> But since I'm not a committer, I'd rather make > >>>> things easier for > >>>>> the committers. I have no control over how > easy > >> or > >>>> difficult it is > >>>>> to handle patches with "extra unintended > >>>> footprints". > >>>>> > >>>>> If I were a committer, I would try to > >>>> automatically filter out > >>>>> formatting changes in my audit, and then > INCLUDE > >>>> the formatting > >>>>> changes. After all, there's no harm removing > >> some > >>>> extra spaces at > >>>>> the end of lines, part of clean up. > >>>>> > >>>>> We often try to make things easier for the > >> person > >>>> who is doing a > >>>>> task that we have no control over. Eg, I'd > keep > >> my > >>>> mouth really > >>>>> wide open for my dentist just so his vision is > >>>> 20/20, no arguments > >>>>> from me; I could afford to be slack about this > >>>> "mouth wide-open > >>>>> policy" if I were able to do the dentistry > >> myself. > >>>>> > >>>>> But you're certainly right that it'll exclude > >> some > >>>> people, > >>>>> especially folks who use editors that do not > >> give > >>>> very much control > >>>>> to users. > >>>>> > >>>>> Jonathon > >>>>> > >>>>> Chris Howe wrote: > >>>>>> I don't know that rejection policies are very > >>>>>> community friendly. Treating SVN code > changes > >>>> like > >>>>>> the keeper of the Bridge of Death (Monty > Python > >>>>>> Reference, smile) may find less people > willing > >> to > >>>> do > >>>>>> in this do-ocracy. Many of us rather like > >> what's > >>>> left > >>>>>> of our anarco-sydicalist commune (oh look, > >>>> there's > >>>>>> another :-) ). > >>>>>> --- Jonathon -- Improov <[hidden email]> > >> wrote: > >>>>>>> David, > >>>>>>> > >>>>>>> I agree with the rejection policy. > >>>>>>> > >>>>>>> One suggestion on procedure to take when > >>>>>>> self-reviewing a patch before submitting it. > >>>> Look at > >>>>>>> the diff to see if there are changes we > cannot > >>>> account > >>>>>>> for. Using KDiff also makes things easier, > >> even > >>>> when dealing with > >>>>>>> formatting changes. > >>>>>>> > >>>>>>> In Emacs, it's also easy to go through every > >> set > >>>> of > >>>>>>> changes, do an interactive-search for 1st > |
In reply to this post by cjhowe
Chris has a point. There's definitely an implicit "rejection policy" already in place.
Given a strong rejection policy, there are 2 opposite spectrums to its implementation. You can follow the Singapore method that says "Our fatherland says this, so this is it. You cannot make a U-turn because the law book didn't say you can do so on that road". Or you can say "please try to do this, but we'll look at your case and let you through the first few times". (Frankly, the 1st method is LAZY; the 2nd takes more effort and is human-friendly.) I've submitted about 3-4 patches, 3 (75-90%) of those early patches have wrong "path to file" (I created patch from same folder as patched file, not from root with folders like application, framework, etc). Jacopo mentioned it to me twice or thrice. I got the message. But of course, there can be those who are completely out of line all the time, no matter what you tell them. Still, it could definitely save Jacopo A TON of time if he were officially allowed to respond with short default message: "Sorry, I can't look at your patch at all due to time constraints. Please refer to best practices page to correct your patch first. Or give patch to some kind community member who will correct it for you. Sorry for the inconvenience." Now that would be better than: "Sorry, patch no good. Please try again." I don't see anyone ever doing this, though. Jonathon Chris Howe wrote: > Being tempted to ask for a vote, insinuates that you > want to condone a practice whereby if you go to review > a patch like in Adrian's case and it has superflous > formatting changes, that you would delete it from JIRA > in a "sorry kid, you're wasting my time" dismissal > (email impressions added for levity). Anything less > is what is currently going on and wouldn't need a > vote. People aren't tempted to vote on the status > quo. |
In reply to this post by cjhowe
I'm not sure what to say, perhaps what I originally said would be helpful: "People tend to slip things into patches accidentally all the time. I'm tempted to begun the voting process for a new policy that says that if there is anything in the patch file not described in the summary of the patch, then it will be rejected..." -David On Jan 15, 2007, at 10:44 PM, Chris Howe wrote: > Sorry, I don't know why that quote didn't hit me right > the first time. My apologies to W.C. Fields. “Go > away, kid, you bother me”. I really butchered it. I > mean _really :-) > > So, if that's not the policy and procedure you're > looking to adopt, please elaborate on what you're > tempted to propose. > > > --- "David E. Jones" <[hidden email]> wrote: > >> >> You have quite an imagination. >> >> -David >> >> >> On Jan 15, 2007, at 10:01 PM, Chris Howe wrote: >> >>> Being tempted to ask for a vote, insinuates that >> you >>> want to condone a practice whereby if you go to >> review >>> a patch like in Adrian's case and it has >> superflous >>> formatting changes, that you would delete it from >> JIRA >>> in a "sorry kid, you're wasting my time" dismissal >>> (email impressions added for levity). Anything >> less >>> is what is currently going on and wouldn't need a >>> vote. People aren't tempted to vote on the status >>> quo. >>> >>> --- "David E. Jones" <[hidden email]> >> wrote: >>> >>>> >>>> Ummm... what do you think when you think of a >>>> rejection policy? We >>>> already have patch rejection policies when >> problems >>>> are found... >>>> >>>> -David >>>> >>>> >>>> On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: >>>> >>>>> I agree. I think it's better that we strongly >>>>> encourage certain practices (as we are doing >> now) >>>> and >>>>> bring people to notice when those practices >> could >>>> be >>>>> improved, but rejection policies put your _means >>>>> perspective ahead of your _ends. Contributions >>>> may be >>>>> easier to review, but I can gaurantee you with >>>>> rejection policies, you will then have less of >> it >>>> to >>>>> review and thereby less solutions making it back >>>> into >>>>> the project. >>>>> >>>>> --- "David E. Jones" <[hidden email]> >>>> wrote: >>>>> >>>>>> >>>>>> Yes, we want more people, but I don't think >>>> anyone >>>>>> wants >>>>>> indiscriminate changes going into SVN! I hate >>>>>> surprises when I check >>>>>> out as much as the next guy, probably more than >>>> the >>>>>> next guy in many >>>>>> cases. >>>>>> >>>>>> Thinking about the next guy is the real key >> here. >>>>>> You may want to get >>>>>> your patches in ASAP, but if your patch breaks >>>>>> existing code (for >>>>>> example), then that needs to be fixed before >> the >>>>>> commit is done >>>>>> (either by the committer, the contributor, or >> an >>>>>> interested third >>>>>> party). >>>>>> >>>>>> So, yeah, that slows things down and is >>>>>> inconvenient, but keep in >>>>>> mind that a large portion of patches that come >>>> into >>>>>> OFBiz break >>>>>> existing functionality. This seems to happen >>>> around >>>>>> once a week or >>>>>> so, at least. >>>>>> >>>>>> It's great that people want to contribute, but >> in >>>> or >>>>>> to contribute to >>>>>> something as large and complex as OFBiz a large >>>>>> amount of effort is >>>>>> necessary, and anyone that wants to help out >> will >>>>>> err on the side of >>>>>> extra effort, caution and review, and >>>> consideration >>>>>> of more general >>>>>> requirements and designs rather just one's own >>>>>> requirements. >>>>>> >>>>>> -David >>>>>> >>>>>> >>>>>> >>>>>> On Jan 15, 2007, at 7:42 PM, Jonathon -- >> Improov >>>>>> wrote: >>>>>> >>>>>>> Heh. True. I definitely want MORE people >>>> involved >>>>>> in OFBiz. >>>>>>> >>>>>>> But since I'm not a committer, I'd rather make >>>>>> things easier for >>>>>>> the committers. I have no control over how >> easy >>>> or >>>>>> difficult it is >>>>>>> to handle patches with "extra unintended >>>>>> footprints". >>>>>>> >>>>>>> If I were a committer, I would try to >>>>>> automatically filter out >>>>>>> formatting changes in my audit, and then >> INCLUDE >>>>>> the formatting >>>>>>> changes. After all, there's no harm removing >>>> some >>>>>> extra spaces at >>>>>>> the end of lines, part of clean up. >>>>>>> >>>>>>> We often try to make things easier for the >>>> person >>>>>> who is doing a >>>>>>> task that we have no control over. Eg, I'd >> keep >>>> my >>>>>> mouth really >>>>>>> wide open for my dentist just so his vision is >>>>>> 20/20, no arguments >>>>>>> from me; I could afford to be slack about this >>>>>> "mouth wide-open >>>>>>> policy" if I were able to do the dentistry >>>> myself. >>>>>>> >>>>>>> But you're certainly right that it'll exclude >>>> some >>>>>> people, >>>>>>> especially folks who use editors that do not >>>> give >>>>>> very much control >>>>>>> to users. >>>>>>> >>>>>>> Jonathon >>>>>>> >>>>>>> Chris Howe wrote: >>>>>>>> I don't know that rejection policies are very >>>>>>>> community friendly. Treating SVN code >> changes >>>>>> like >>>>>>>> the keeper of the Bridge of Death (Monty >> Python >>>>>>>> Reference, smile) may find less people >> willing >>>> to >>>>>> do >>>>>>>> in this do-ocracy. Many of us rather like >>>> what's >>>>>> left >>>>>>>> of our anarco-sydicalist commune (oh look, >>>>>> there's >>>>>>>> another :-) ). >>>>>>>> --- Jonathon -- Improov <[hidden email]> >>>> wrote: >>>>>>>>> David, >>>>>>>>> >>>>>>>>> I agree with the rejection policy. >>>>>>>>> >>>>>>>>> One suggestion on procedure to take when >>>>>>>>> self-reviewing a patch before submitting it. >>>>>> Look at >>>>>>>>> the diff to see if there are changes we >> cannot >>>>>> account >>>>>>>>> for. Using KDiff also makes things easier, >>>> even >>>>>> when dealing with >>>>>>>>> formatting changes. >>>>>>>>> >>>>>>>>> In Emacs, it's also easy to go through every >>>> set >>>>>> of >>>>>>>>> changes, do an interactive-search for 1st >> > === message truncated === > smime.p7s (3K) Download Attachment |
So, then how does the parodied scenario demonstrate an
imagination if that's exactly what you're wanting to do? --- "David E. Jones" <[hidden email]> wrote: > > I'm not sure what to say, perhaps what I originally > said would be > helpful: > > "People tend to slip things into patches > accidentally all the time. > I'm tempted to begun the voting process for a new > policy that says > that if there is anything in the patch file not > described in the > summary of the patch, then it will be rejected..." > > -David > > > On Jan 15, 2007, at 10:44 PM, Chris Howe wrote: > > > Sorry, I don't know why that quote didn't hit me > right > > the first time. My apologies to W.C. Fields. Go > > away, kid, you bother me. I really butchered it. > I > > mean _really :-) > > > > So, if that's not the policy and procedure you're > > looking to adopt, please elaborate on what you're > > tempted to propose. > > > > > > --- "David E. Jones" <[hidden email]> > wrote: > > > >> > >> You have quite an imagination. > >> > >> -David > >> > >> > >> On Jan 15, 2007, at 10:01 PM, Chris Howe wrote: > >> > >>> Being tempted to ask for a vote, insinuates that > >> you > >>> want to condone a practice whereby if you go to > >> review > >>> a patch like in Adrian's case and it has > >> superflous > >>> formatting changes, that you would delete it > from > >> JIRA > >>> in a "sorry kid, you're wasting my time" > dismissal > >>> (email impressions added for levity). Anything > >> less > >>> is what is currently going on and wouldn't need > a > >>> vote. People aren't tempted to vote on the > status > >>> quo. > >>> > >>> --- "David E. Jones" <[hidden email]> > >> wrote: > >>> > >>>> > >>>> Ummm... what do you think when you think of a > >>>> rejection policy? We > >>>> already have patch rejection policies when > >> problems > >>>> are found... > >>>> > >>>> -David > >>>> > >>>> > >>>> On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > >>>> > >>>>> I agree. I think it's better that we strongly > >>>>> encourage certain practices (as we are doing > >> now) > >>>> and > >>>>> bring people to notice when those practices > >> could > >>>> be > >>>>> improved, but rejection policies put your > _means > >>>>> perspective ahead of your _ends. > Contributions > >>>> may be > >>>>> easier to review, but I can gaurantee you with > >>>>> rejection policies, you will then have less of > >> it > >>>> to > >>>>> review and thereby less solutions making it > back > >>>> into > >>>>> the project. > >>>>> > >>>>> --- "David E. Jones" <[hidden email]> > >>>> wrote: > >>>>> > >>>>>> > >>>>>> Yes, we want more people, but I don't think > >>>> anyone > >>>>>> wants > >>>>>> indiscriminate changes going into SVN! I hate > >>>>>> surprises when I check > >>>>>> out as much as the next guy, probably more > than > >>>> the > >>>>>> next guy in many > >>>>>> cases. > >>>>>> > >>>>>> Thinking about the next guy is the real key > >> here. > >>>>>> You may want to get > >>>>>> your patches in ASAP, but if your patch > breaks > >>>>>> existing code (for > >>>>>> example), then that needs to be fixed before > >> the > >>>>>> commit is done > >>>>>> (either by the committer, the contributor, or > >> an > >>>>>> interested third > >>>>>> party). > >>>>>> > >>>>>> So, yeah, that slows things down and is > >>>>>> inconvenient, but keep in > >>>>>> mind that a large portion of patches that > come > >>>> into > >>>>>> OFBiz break > >>>>>> existing functionality. This seems to happen > >>>> around > >>>>>> once a week or > >>>>>> so, at least. > >>>>>> > >>>>>> It's great that people want to contribute, > but > >> in > >>>> or > >>>>>> to contribute to > >>>>>> something as large and complex as OFBiz a > large > >>>>>> amount of effort is > >>>>>> necessary, and anyone that wants to help out > >> will > >>>>>> err on the side of > >>>>>> extra effort, caution and review, and > >>>> consideration > >>>>>> of more general > >>>>>> requirements and designs rather just one's > own > >>>>>> requirements. > >>>>>> > >>>>>> -David > >>>>>> > >>>>>> > >>>>>> > >>>>>> On Jan 15, 2007, at 7:42 PM, Jonathon -- > >> Improov > >>>>>> wrote: > >>>>>> > >>>>>>> Heh. True. I definitely want MORE people > >>>> involved > >>>>>> in OFBiz. > >>>>>>> > >>>>>>> But since I'm not a committer, I'd rather > make > >>>>>> things easier for > >>>>>>> the committers. I have no control over how > >> easy > >>>> or > >>>>>> difficult it is > >>>>>>> to handle patches with "extra unintended > >>>>>> footprints". > >>>>>>> > >>>>>>> If I were a committer, I would try to > >>>>>> automatically filter out > >>>>>>> formatting changes in my audit, and then > >> INCLUDE > >>>>>> the formatting > >>>>>>> changes. After all, there's no harm removing > >>>> some > >>>>>> extra spaces at > >>>>>>> the end of lines, part of clean up. > >>>>>>> > >>>>>>> We often try to make things easier for the > >>>> person > >>>>>> who is doing a > >>>>>>> task that we have no control over. Eg, I'd > >> keep > >>>> my > >>>>>> mouth really > >>>>>>> wide open for my dentist just so his vision > is > >>>>>> 20/20, no arguments > >>>>>>> from me; I could afford to be slack about > this > >>>>>> "mouth wide-open > >>>>>>> policy" if I were able to do the dentistry > >>>> myself. > |
In reply to this post by David E Jones
> So, yeah, that slows things down and is inconvenient, but keep in
> mind that a large portion of patches that come into OFBiz break > existing functionality. This seems to happen around once a week or > so, at least. Automated testing should help with this. If I may make a suggestion, it would be that instead of having a policy, that you trust the good sense of the OFBiz team. If a patch has a bunch of changes that don't relate to the code, then a developer ought to be able to say "please don't do that, here's why" (in a FAQ?) or not, depending on the situation at hand. -- David N. Welton - http://www.dedasys.com/davidw/ Linux, Open Source Consulting - http://www.dedasys.com/ |
Administrator
|
In reply to this post by Guido Amarilla
Guido,
BTW, next time you propose a patch with new files in it, please don't forget to add the ASL 2 headers in them, thanks. This of course is true for everybody ;o) Jacques ----- Original Message ----- From: "Guido Amarilla" <[hidden email]> To: <[hidden email]> Sent: Tuesday, January 16, 2007 5:58 AM Subject: Re: OFBiz UI work > I´m giving my opinion, because it seems obvious to me that if you > reject a patch, the contributor will correct it in the 99% of the > times...and will learn, so the next time he probably won´t commit the > same mistakes. > This way we reduce the effort to the few commiters increasing the > chances for them to commit other patches.... > > Stronger policies: +1 > > 2007/1/16, David E. Jones <[hidden email]>: > > > > Ummm... what do you think when you think of a rejection policy? We > > already have patch rejection policies when problems are found... > > > > -David > > > > > > On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > > > > > I agree. I think it's better that we strongly > > > encourage certain practices (as we are doing now) and > > > bring people to notice when those practices could be > > > improved, but rejection policies put your _means > > > perspective ahead of your _ends. Contributions may be > > > easier to review, but I can gaurantee you with > > > rejection policies, you will then have less of it to > > > review and thereby less solutions making it back into > > > the project. > > > > > > --- "David E. Jones" <[hidden email]> wrote: > > > > > >> > > >> Yes, we want more people, but I don't think anyone > > >> wants > > >> indiscriminate changes going into SVN! I hate > > >> surprises when I check > > >> out as much as the next guy, probably more than the > > >> next guy in many > > >> cases. > > >> > > >> Thinking about the next guy is the real key here. > > >> You may want to get > > >> your patches in ASAP, but if your patch breaks > > >> existing code (for > > >> example), then that needs to be fixed before the > > >> commit is done > > >> (either by the committer, the contributor, or an > > >> interested third > > >> party). > > >> > > >> So, yeah, that slows things down and is > > >> inconvenient, but keep in > > >> mind that a large portion of patches that come into > > >> OFBiz break > > >> existing functionality. This seems to happen around > > >> once a week or > > >> so, at least. > > >> > > >> It's great that people want to contribute, but in or > > >> to contribute to > > >> something as large and complex as OFBiz a large > > >> amount of effort is > > >> necessary, and anyone that wants to help out will > > >> err on the side of > > >> extra effort, caution and review, and consideration > > >> of more general > > >> requirements and designs rather just one's own > > >> requirements. > > >> > > >> -David > > >> > > >> > > >> > > >> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov > > >> wrote: > > >> > > >>> Heh. True. I definitely want MORE people involved > > >> in OFBiz. > > >>> > > >>> But since I'm not a committer, I'd rather make > > >> things easier for > > >>> the committers. I have no control over how easy or > > >> difficult it is > > >>> to handle patches with "extra unintended > > >> footprints". > > >>> > > >>> If I were a committer, I would try to > > >> automatically filter out > > >>> formatting changes in my audit, and then INCLUDE > > >> the formatting > > >>> changes. After all, there's no harm removing some > > >> extra spaces at > > >>> the end of lines, part of clean up. > > >>> > > >>> We often try to make things easier for the person > > >> who is doing a > > >>> task that we have no control over. Eg, I'd keep my > > >> mouth really > > >>> wide open for my dentist just so his vision is > > >> 20/20, no arguments > > >>> from me; I could afford to be slack about this > > >> "mouth wide-open > > >>> policy" if I were able to do the dentistry myself. > > >>> > > >>> But you're certainly right that it'll exclude some > > >> people, > > >>> especially folks who use editors that do not give > > >> very much control > > >>> to users. > > >>> > > >>> Jonathon > > >>> > > >>> Chris Howe wrote: > > >>>> I don't know that rejection policies are very > > >>>> community friendly. Treating SVN code changes > > >> like > > >>>> the keeper of the Bridge of Death (Monty Python > > >>>> Reference, smile) may find less people willing to > > >> do > > >>>> in this do-ocracy. Many of us rather like what's > > >> left > > >>>> of our anarco-sydicalist commune (oh look, > > >> there's > > >>>> another :-) ). > > >>>> --- Jonathon -- Improov <[hidden email]> wrote: > > >>>>> David, > > >>>>> > > >>>>> I agree with the rejection policy. > > >>>>> > > >>>>> One suggestion on procedure to take when > > >>>>> self-reviewing a patch before submitting it. > > >> Look at > > >>>>> the diff to see if there are changes we cannot > > >> account > > >>>>> for. Using KDiff also makes things easier, even > > >> when dealing with > > >>>>> formatting changes. > > >>>>> > > >>>>> In Emacs, it's also easy to go through every set > > >> of > > >>>>> changes, do an interactive-search for 1st entry > > >> of each set, and > > >>>>> see if the 2nd entry is > > >>>>> highlighted similarly. Meaning, if it is > > >> highlighted similarly, > > >>>>> the set of changes is bogus > > >>>>> (formatting only). > > >>>>> > > >>>>> In general, we should submit patches that are > > >>>>> intentional, ie just the intended changes only. > > >> We should not > > >>>>> submit patches that contain unintended > > >>>>> changes that have extra unintended footprints. > > >>>>> > > >>>>> Jonathon > > >>>>> > > >>>>> David E. Jones wrote: > > >>>>>> Moving this back to the mailing list... > > >>>>>> > > >>>>>> > > >>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > > >>>>>> > > >>>>>>> David E. Jones wrote: > > >>>>>>>> When reviewing a patch lines with formatting > > >>>>> changes only are > > >>>>>>>> EXTREMELY time consuming, and the patch > > >>>>> attached that issue is a > > >>>>>>>> good example of a painful one. For each of > > >>>>> those line you have to > > >>>>>>>> stare at it looking at every character trying > > >>>>> to figure out what the > > >>>>>>>> point of the bloody change was, or to make > > >> sure > > >>>>> that the change is > > >>>>>>>> "invisible"... > > >>>>>>> That really puzzles me. You keep mentioning > > >>>>> formatting changes when I > > >>>>>>> don't see any. I didn't make any formatting > > >>>>> changes when modifying the > > >>>>>>> files. Even now when I look at the patch in > > >> Jira, > > >>>>> it shows only the > > >>>>>>> lines I changed in the file. > > >>>>>>> > > >>>>>>> *shrug* > > >>>>>> As others may have the same question I'll > > >> answer > > >>>>> it on the mailing list. > > >>>>>> Below is the first section from the > > >>>>> framework_v2.patch file on the > > >>>>>> > > >> [https://issues.apache.org/jira/browse/OFBIZ-605] > > >>>>> issue. > > >>>>>> Each change is marked with a "-" for a line > > >>>>> removed or a "+" for a line > > >>>>>> added. > > >>>>>> > > >>>>>> First Set: formatting, or "invisible" change > > >>>>>> > > >>>>>> Second Set: add comment (not necessary, BTW as > > >> it > > >>>>> describes something > > >>>>>> that no longer exists; if people want to see > > >> old > > >>>>> stuff they can look at > > >>>>>> the SVN history); remove tabstyles.css link tag > > >>>>>> > > >>>>>> Third Set: formatting, or "invisible" change > > >>>>>> > > >>>>>> Of all of these changes, only the "remove > > >>>>> tabstyles.css link tag" was > > >>>>>> actually intended and necessary, but getting to > > >>>>> this fact when reviewing > > >>>>>> the changes takes some time... this making it > > >> more > > >>>>> difficult to review, > > >>>>>> commit, etc. > > >>>>>> > > >>>>>> People tend to slip things into patches > > >>>>> accidentally all the time. I'm > > >>>>>> tempted to begun the voting process for a new > > >>>>> policy that says that if > > >>>>>> there is anything in the patch file not > > >> described > > >>>>> in the summary of the > > >>>>>> patch, then it will be rejected... > > >>>>>> > > >>>>>> -David > > >>>>>> > > >>>>>> > > >>>>>> ======================== > > >>>>>> Index: common/webcommon/includes/header.ftl > > >> > > > === message truncated === > > > > > > > > > > > > > > -- > Guido Amarilla |
Administrator
|
In reply to this post by jonwimp
From: "Jonathon -- Improov" <[hidden email]>
> Chris has a point. There's definitely an implicit "rejection policy" already in place. [...snip...] > I've submitted about 3-4 patches, 3 (75-90%) of those early patches have wrong "path to file" (I > created patch from same folder as patched file, not from root with folders like application, > framework, etc). Jacopo mentioned it to me twice or thrice. I got the message. > > But of course, there can be those who are completely out of line all the time, no matter what you > tell them. > > Still, it could definitely save Jacopo A TON of time if he were officially allowed to respond with > short default message: "Sorry, I can't look at your patch at all due to time constraints. Please > refer to best practices page to correct your patch first. Or give patch to some kind community > member who will correct it for you. Sorry for the inconvenience." BTW it was not Jacopo but me ;o) Jacques > Now that would be better than: "Sorry, patch no good. Please try again." I don't see anyone ever > doing this, though. > > Jonathon |
In reply to this post by Jacques Le Roux
Jacques,
That´s what I was talking about. You just should have rejected my patch explaining the reason and I should have corrected it and re-submitting. BTW, I did my homework and faxed a signed iCLA to The Apache Foundation. Guido. 2007/1/16, Jacques Le Roux <[hidden email]>: > Guido, > > BTW, next time you propose a patch with new files in it, please don't forget to add the ASL 2 headers in them, thanks. > > This of course is true for everybody ;o) > > Jacques > > ----- Original Message ----- > From: "Guido Amarilla" <[hidden email]> > To: <[hidden email]> > Sent: Tuesday, January 16, 2007 5:58 AM > Subject: Re: OFBiz UI work > > > > I´m giving my opinion, because it seems obvious to me that if you > > reject a patch, the contributor will correct it in the 99% of the > > times...and will learn, so the next time he probably won´t commit the > > same mistakes. > > This way we reduce the effort to the few commiters increasing the > > chances for them to commit other patches.... > > > > Stronger policies: +1 > > > > 2007/1/16, David E. Jones <[hidden email]>: > > > > > > Ummm... what do you think when you think of a rejection policy? We > > > already have patch rejection policies when problems are found... > > > > > > -David > > > > > > > > > On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > > > > > > > I agree. I think it's better that we strongly > > > > encourage certain practices (as we are doing now) and > > > > bring people to notice when those practices could be > > > > improved, but rejection policies put your _means > > > > perspective ahead of your _ends. Contributions may be > > > > easier to review, but I can gaurantee you with > > > > rejection policies, you will then have less of it to > > > > review and thereby less solutions making it back into > > > > the project. > > > > > > > > --- "David E. Jones" <[hidden email]> wrote: > > > > > > > >> > > > >> Yes, we want more people, but I don't think anyone > > > >> wants > > > >> indiscriminate changes going into SVN! I hate > > > >> surprises when I check > > > >> out as much as the next guy, probably more than the > > > >> next guy in many > > > >> cases. > > > >> > > > >> Thinking about the next guy is the real key here. > > > >> You may want to get > > > >> your patches in ASAP, but if your patch breaks > > > >> existing code (for > > > >> example), then that needs to be fixed before the > > > >> commit is done > > > >> (either by the committer, the contributor, or an > > > >> interested third > > > >> party). > > > >> > > > >> So, yeah, that slows things down and is > > > >> inconvenient, but keep in > > > >> mind that a large portion of patches that come into > > > >> OFBiz break > > > >> existing functionality. This seems to happen around > > > >> once a week or > > > >> so, at least. > > > >> > > > >> It's great that people want to contribute, but in or > > > >> to contribute to > > > >> something as large and complex as OFBiz a large > > > >> amount of effort is > > > >> necessary, and anyone that wants to help out will > > > >> err on the side of > > > >> extra effort, caution and review, and consideration > > > >> of more general > > > >> requirements and designs rather just one's own > > > >> requirements. > > > >> > > > >> -David > > > >> > > > >> > > > >> > > > >> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov > > > >> wrote: > > > >> > > > >>> Heh. True. I definitely want MORE people involved > > > >> in OFBiz. > > > >>> > > > >>> But since I'm not a committer, I'd rather make > > > >> things easier for > > > >>> the committers. I have no control over how easy or > > > >> difficult it is > > > >>> to handle patches with "extra unintended > > > >> footprints". > > > >>> > > > >>> If I were a committer, I would try to > > > >> automatically filter out > > > >>> formatting changes in my audit, and then INCLUDE > > > >> the formatting > > > >>> changes. After all, there's no harm removing some > > > >> extra spaces at > > > >>> the end of lines, part of clean up. > > > >>> > > > >>> We often try to make things easier for the person > > > >> who is doing a > > > >>> task that we have no control over. Eg, I'd keep my > > > >> mouth really > > > >>> wide open for my dentist just so his vision is > > > >> 20/20, no arguments > > > >>> from me; I could afford to be slack about this > > > >> "mouth wide-open > > > >>> policy" if I were able to do the dentistry myself. > > > >>> > > > >>> But you're certainly right that it'll exclude some > > > >> people, > > > >>> especially folks who use editors that do not give > > > >> very much control > > > >>> to users. > > > >>> > > > >>> Jonathon > > > >>> > > > >>> Chris Howe wrote: > > > >>>> I don't know that rejection policies are very > > > >>>> community friendly. Treating SVN code changes > > > >> like > > > >>>> the keeper of the Bridge of Death (Monty Python > > > >>>> Reference, smile) may find less people willing to > > > >> do > > > >>>> in this do-ocracy. Many of us rather like what's > > > >> left > > > >>>> of our anarco-sydicalist commune (oh look, > > > >> there's > > > >>>> another :-) ). > > > >>>> --- Jonathon -- Improov <[hidden email]> wrote: > > > >>>>> David, > > > >>>>> > > > >>>>> I agree with the rejection policy. > > > >>>>> > > > >>>>> One suggestion on procedure to take when > > > >>>>> self-reviewing a patch before submitting it. > > > >> Look at > > > >>>>> the diff to see if there are changes we cannot > > > >> account > > > >>>>> for. Using KDiff also makes things easier, even > > > >> when dealing with > > > >>>>> formatting changes. > > > >>>>> > > > >>>>> In Emacs, it's also easy to go through every set > > > >> of > > > >>>>> changes, do an interactive-search for 1st entry > > > >> of each set, and > > > >>>>> see if the 2nd entry is > > > >>>>> highlighted similarly. Meaning, if it is > > > >> highlighted similarly, > > > >>>>> the set of changes is bogus > > > >>>>> (formatting only). > > > >>>>> > > > >>>>> In general, we should submit patches that are > > > >>>>> intentional, ie just the intended changes only. > > > >> We should not > > > >>>>> submit patches that contain unintended > > > >>>>> changes that have extra unintended footprints. > > > >>>>> > > > >>>>> Jonathon > > > >>>>> > > > >>>>> David E. Jones wrote: > > > >>>>>> Moving this back to the mailing list... > > > >>>>>> > > > >>>>>> > > > >>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > > > >>>>>> > > > >>>>>>> David E. Jones wrote: > > > >>>>>>>> When reviewing a patch lines with formatting > > > >>>>> changes only are > > > >>>>>>>> EXTREMELY time consuming, and the patch > > > >>>>> attached that issue is a > > > >>>>>>>> good example of a painful one. For each of > > > >>>>> those line you have to > > > >>>>>>>> stare at it looking at every character trying > > > >>>>> to figure out what the > > > >>>>>>>> point of the bloody change was, or to make > > > >> sure > > > >>>>> that the change is > > > >>>>>>>> "invisible"... > > > >>>>>>> That really puzzles me. You keep mentioning > > > >>>>> formatting changes when I > > > >>>>>>> don't see any. I didn't make any formatting > > > >>>>> changes when modifying the > > > >>>>>>> files. Even now when I look at the patch in > > > >> Jira, > > > >>>>> it shows only the > > > >>>>>>> lines I changed in the file. > > > >>>>>>> > > > >>>>>>> *shrug* > > > >>>>>> As others may have the same question I'll > > > >> answer > > > >>>>> it on the mailing list. > > > >>>>>> Below is the first section from the > > > >>>>> framework_v2.patch file on the > > > >>>>>> > > > >> [https://issues.apache.org/jira/browse/OFBIZ-605] > > > >>>>> issue. > > > >>>>>> Each change is marked with a "-" for a line > > > >>>>> removed or a "+" for a line > > > >>>>>> added. > > > >>>>>> > > > >>>>>> First Set: formatting, or "invisible" change > > > >>>>>> > > > >>>>>> Second Set: add comment (not necessary, BTW as > > > >> it > > > >>>>> describes something > > > >>>>>> that no longer exists; if people want to see > > > >> old > > > >>>>> stuff they can look at > > > >>>>>> the SVN history); remove tabstyles.css link tag > > > >>>>>> > > > >>>>>> Third Set: formatting, or "invisible" change > > > >>>>>> > > > >>>>>> Of all of these changes, only the "remove > > > >>>>> tabstyles.css link tag" was > > > >>>>>> actually intended and necessary, but getting to > > > >>>>> this fact when reviewing > > > >>>>>> the changes takes some time... this making it > > > >> more > > > >>>>> difficult to review, > > > >>>>>> commit, etc. > > > >>>>>> > > > >>>>>> People tend to slip things into patches > > > >>>>> accidentally all the time. I'm > > > >>>>>> tempted to begun the voting process for a new > > > >>>>> policy that says that if > > > >>>>>> there is anything in the patch file not > > > >> described > > > >>>>> in the summary of the > > > >>>>>> patch, then it will be rejected... > > > >>>>>> > > > >>>>>> -David > > > >>>>>> > > > >>>>>> > > > >>>>>> ======================== > > > >>>>>> Index: common/webcommon/includes/header.ftl > > > >> > > > > === message truncated === > > > > > > > > > > > > > > > > > > > > > > -- > > Guido Amarilla > > -- Guido Amarilla |
Administrator
|
Guido,
From: "Guido Amarilla" <[hidden email]> > Jacques, > That´s what I was talking about. You just should have rejected my > patch explaining the reason and I should have corrected it and > re-submitting. Yes, seems the better way indeed. Actually I did not notice that this was new files. It's only after Marco Risaliti reminder on another commit that I noticed the problem and corrected it. > BTW, I did my homework and faxed a signed iCLA to The Apache Foundation. Great ! Jaques > Guido. > > 2007/1/16, Jacques Le Roux <[hidden email]>: > > Guido, > > > > BTW, next time you propose a patch with new files in it, please don't forget to add the ASL 2 headers in them, thanks. > > > > This of course is true for everybody ;o) > > > > Jacques > > > > ----- Original Message ----- > > From: "Guido Amarilla" <[hidden email]> > > To: <[hidden email]> > > Sent: Tuesday, January 16, 2007 5:58 AM > > Subject: Re: OFBiz UI work > > > > > > > I´m giving my opinion, because it seems obvious to me that if you > > > reject a patch, the contributor will correct it in the 99% of the > > > times...and will learn, so the next time he probably won´t commit the > > > same mistakes. > > > This way we reduce the effort to the few commiters increasing the > > > chances for them to commit other patches.... > > > > > > Stronger policies: +1 > > > > > > 2007/1/16, David E. Jones <[hidden email]>: > > > > > > > > Ummm... what do you think when you think of a rejection policy? We > > > > already have patch rejection policies when problems are found... > > > > > > > > -David > > > > > > > > > > > > On Jan 15, 2007, at 9:44 PM, Chris Howe wrote: > > > > > > > > > I agree. I think it's better that we strongly > > > > > encourage certain practices (as we are doing now) and > > > > > bring people to notice when those practices could be > > > > > improved, but rejection policies put your _means > > > > > perspective ahead of your _ends. Contributions may be > > > > > easier to review, but I can gaurantee you with > > > > > rejection policies, you will then have less of it to > > > > > review and thereby less solutions making it back into > > > > > the project. > > > > > > > > > > --- "David E. Jones" <[hidden email]> wrote: > > > > > > > > > >> > > > > >> Yes, we want more people, but I don't think anyone > > > > >> wants > > > > >> indiscriminate changes going into SVN! I hate > > > > >> surprises when I check > > > > >> out as much as the next guy, probably more than the > > > > >> next guy in many > > > > >> cases. > > > > >> > > > > >> Thinking about the next guy is the real key here. > > > > >> You may want to get > > > > >> your patches in ASAP, but if your patch breaks > > > > >> existing code (for > > > > >> example), then that needs to be fixed before the > > > > >> commit is done > > > > >> (either by the committer, the contributor, or an > > > > >> interested third > > > > >> party). > > > > >> > > > > >> So, yeah, that slows things down and is > > > > >> inconvenient, but keep in > > > > >> mind that a large portion of patches that come into > > > > >> OFBiz break > > > > >> existing functionality. This seems to happen around > > > > >> once a week or > > > > >> so, at least. > > > > >> > > > > >> It's great that people want to contribute, but in or > > > > >> to contribute to > > > > >> something as large and complex as OFBiz a large > > > > >> amount of effort is > > > > >> necessary, and anyone that wants to help out will > > > > >> err on the side of > > > > >> extra effort, caution and review, and consideration > > > > >> of more general > > > > >> requirements and designs rather just one's own > > > > >> requirements. > > > > >> > > > > >> -David > > > > >> > > > > >> > > > > >> > > > > >> On Jan 15, 2007, at 7:42 PM, Jonathon -- Improov > > > > >> wrote: > > > > >> > > > > >>> Heh. True. I definitely want MORE people involved > > > > >> in OFBiz. > > > > >>> > > > > >>> But since I'm not a committer, I'd rather make > > > > >> things easier for > > > > >>> the committers. I have no control over how easy or > > > > >> difficult it is > > > > >>> to handle patches with "extra unintended > > > > >> footprints". > > > > >>> > > > > >>> If I were a committer, I would try to > > > > >> automatically filter out > > > > >>> formatting changes in my audit, and then INCLUDE > > > > >> the formatting > > > > >>> changes. After all, there's no harm removing some > > > > >> extra spaces at > > > > >>> the end of lines, part of clean up. > > > > >>> > > > > >>> We often try to make things easier for the person > > > > >> who is doing a > > > > >>> task that we have no control over. Eg, I'd keep my > > > > >> mouth really > > > > >>> wide open for my dentist just so his vision is > > > > >> 20/20, no arguments > > > > >>> from me; I could afford to be slack about this > > > > >> "mouth wide-open > > > > >>> policy" if I were able to do the dentistry myself. > > > > >>> > > > > >>> But you're certainly right that it'll exclude some > > > > >> people, > > > > >>> especially folks who use editors that do not give > > > > >> very much control > > > > >>> to users. > > > > >>> > > > > >>> Jonathon > > > > >>> > > > > >>> Chris Howe wrote: > > > > >>>> I don't know that rejection policies are very > > > > >>>> community friendly. Treating SVN code changes > > > > >> like > > > > >>>> the keeper of the Bridge of Death (Monty Python > > > > >>>> Reference, smile) may find less people willing to > > > > >> do > > > > >>>> in this do-ocracy. Many of us rather like what's > > > > >> left > > > > >>>> of our anarco-sydicalist commune (oh look, > > > > >> there's > > > > >>>> another :-) ). > > > > >>>> --- Jonathon -- Improov <[hidden email]> wrote: > > > > >>>>> David, > > > > >>>>> > > > > >>>>> I agree with the rejection policy. > > > > >>>>> > > > > >>>>> One suggestion on procedure to take when > > > > >>>>> self-reviewing a patch before submitting it. > > > > >> Look at > > > > >>>>> the diff to see if there are changes we cannot > > > > >> account > > > > >>>>> for. Using KDiff also makes things easier, even > > > > >> when dealing with > > > > >>>>> formatting changes. > > > > >>>>> > > > > >>>>> In Emacs, it's also easy to go through every set > > > > >> of > > > > >>>>> changes, do an interactive-search for 1st entry > > > > >> of each set, and > > > > >>>>> see if the 2nd entry is > > > > >>>>> highlighted similarly. Meaning, if it is > > > > >> highlighted similarly, > > > > >>>>> the set of changes is bogus > > > > >>>>> (formatting only). > > > > >>>>> > > > > >>>>> In general, we should submit patches that are > > > > >>>>> intentional, ie just the intended changes only. > > > > >> We should not > > > > >>>>> submit patches that contain unintended > > > > >>>>> changes that have extra unintended footprints. > > > > >>>>> > > > > >>>>> Jonathon > > > > >>>>> > > > > >>>>> David E. Jones wrote: > > > > >>>>>> Moving this back to the mailing list... > > > > >>>>>> > > > > >>>>>> > > > > >>>>>> On Jan 15, 2007, at 5:34 PM, Adrian Crum wrote: > > > > >>>>>> > > > > >>>>>>> David E. Jones wrote: > > > > >>>>>>>> When reviewing a patch lines with formatting > > > > >>>>> changes only are > > > > >>>>>>>> EXTREMELY time consuming, and the patch > > > > >>>>> attached that issue is a > > > > >>>>>>>> good example of a painful one. For each of > > > > >>>>> those line you have to > > > > >>>>>>>> stare at it looking at every character trying > > > > >>>>> to figure out what the > > > > >>>>>>>> point of the bloody change was, or to make > > > > >> sure > > > > >>>>> that the change is > > > > >>>>>>>> "invisible"... > > > > >>>>>>> That really puzzles me. You keep mentioning > > > > >>>>> formatting changes when I > > > > >>>>>>> don't see any. I didn't make any formatting > > > > >>>>> changes when modifying the > > > > >>>>>>> files. Even now when I look at the patch in > > > > >> Jira, > > > > >>>>> it shows only the > > > > >>>>>>> lines I changed in the file. > > > > >>>>>>> > > > > >>>>>>> *shrug* > > > > >>>>>> As others may have the same question I'll > > > > >> answer > > > > >>>>> it on the mailing list. > > > > >>>>>> Below is the first section from the > > > > >>>>> framework_v2.patch file on the > > > > >>>>>> > > > > >> [https://issues.apache.org/jira/browse/OFBIZ-605] > > > > >>>>> issue. > > > > >>>>>> Each change is marked with a "-" for a line > > > > >>>>> removed or a "+" for a line > > > > >>>>>> added. > > > > >>>>>> > > > > >>>>>> First Set: formatting, or "invisible" change > > > > >>>>>> > > > > >>>>>> Second Set: add comment (not necessary, BTW as > > > > >> it > > > > >>>>> describes something > > > > >>>>>> that no longer exists; if people want to see > > > > >> old > > > > >>>>> stuff they can look at > > > > >>>>>> the SVN history); remove tabstyles.css link tag > > > > >>>>>> > > > > >>>>>> Third Set: formatting, or "invisible" change > > > > >>>>>> > > > > >>>>>> Of all of these changes, only the "remove > > > > >>>>> tabstyles.css link tag" was > > > > >>>>>> actually intended and necessary, but getting to > > > > >>>>> this fact when reviewing > > > > >>>>>> the changes takes some time... this making it > > > > >> more > > > > >>>>> difficult to review, > > > > >>>>>> commit, etc. > > > > >>>>>> > > > > >>>>>> People tend to slip things into patches > > > > >>>>> accidentally all the time. I'm > > > > >>>>>> tempted to begun the voting process for a new > > > > >>>>> policy that says that if > > > > >>>>>> there is anything in the patch file not > > > > >> described > > > > >>>>> in the summary of the > > > > >>>>>> patch, then it will be rejected... > > > > >>>>>> > > > > >>>>>> -David > > > > >>>>>> > > > > >>>>>> > > > > >>>>>> ======================== > > > > >>>>>> Index: common/webcommon/includes/header.ftl > > > > >> > > > > > === message truncated === > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > Guido Amarilla > > > > > > > -- > Guido Amarilla |
Free forum by Nabble | Edit this page |