Re: 3.0.20 ChangeLog progress
Ian Silvester <[email protected]>
| Newsgroups | gmane.comp.web.privoxy.devel |
|---|---|
| Message-ID | <[email protected]> |
On 2013-01-09, at 5:06 AM, Fabian Keil wrote: > Ian Silvester <[email protected]> wrote: > >> Another question - should I specify each and every case of comment tidying or just add a general "various typo corrections and comprehensibility improvements"? > > As comments affect neither the binary nor the user I don't think > each modification has to be explicitly mentioned. Phew. I was hoping you'd be of that opinion! > In my opinion typo corrections for the documentation can be combined > like you suggested unless the typo caused a lot of confusion. For example > if a directive was consistently written wrong and the user was thus > unable to use it without checking the sources. > > I don't think that ever happened, though. > > In general our ChangeLog is already pretty verbose compared to > ChangeLogs from other projects Yes, I'd noticed!! Still, it has bugged me previously that a project I use fixed a minor issue that affected me but didn't say so in it's changelog so I'd upgrade in hope and only find out that the fix was present when using the software, so I think we're doing the right thing. > and combining a few more entries > probably wouldn't hurt. For example it's unclear how many users > really care about a detailed "Log message improvements" section. I'll see what things look like when I've finished taming the beast (who knew there'd been so many commits in only one year!) and take a view on how many separate sections to include. Should be finished today or tomorrow, Ian > > Fabian > ------------------------------------------------------------------------------ > Master Java SE, Java EE, Eclipse, Spring, Hibernate, JavaScript, jQuery > and much more. Keep your Java skills current with LearnJavaNow - > 200+ hours of step-by-step video tutorials by Java experts. > SALE $49.99 this month only -- learn more at: > http://p.sf.net/sfu/learnmore_122612 _______________________________________________ > Ijbswa-developers mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/ijbswa-developers ------------------------------------------------------------------------------ Master Java SE, Java EE, Eclipse, Spring, Hibernate, JavaScript, jQuery and much more. Keep your Java skills current with LearnJavaNow - 200+ hours of step-by-step video tutorials by Java experts. SALE $49.99 this month only -- learn more at: http://p.sf.net/sfu/learnmore_122612