TLDR: move to merges, make sure merge commits have nice change log style messages, only show merge commit messages (with some script based munging) in the changelog
I tend to agree with you to a large extent. We need an explicit changelog. That is a description of change that is useful and consumable to an end user. That said that description should be part of the commit history (storing relevant information close to where it is relevant). I think we can actually get to this model by moving to merging rather then cherry-pick and signoff. We could quite easily put a nice descriptive comment in the merge commit and then have a script that strips off the not-relevant for changelog git specific bits. On Thu, May 3, 2012 at 11:19 PM, Martin Logan <[email protected]> wrote: > you may want to think about getting rid of the git stuff and just > giving a cleaner release notes. Easier to read and digest the features > that way. Most users don't ned the hash's and such. Author info is > good if it is not you with a thanks to <name> > > On Thu, May 3, 2012 at 3:29 PM, Eric Merritt <[email protected]> wrote: >> This latest sinan should fix all the problems that folks have brought >> up recently. The changelog is below. >> >> Get it in the usual place -> >> https://github.com/erlware/sinan/downloads >> >> CHANGES: >> >> commit 6d6239c4ba09a78dcd6f125d017caaa94fd20ea4 >> Author: Eric Merritt <[email protected]> >> Date: Tue May 1 15:49:28 2012 -0500 >> >> fix bug in detecting change in joxa files >> >> commit 0fb6ed577ba028e56f3f162aa871aefbae4e6f94 >> Author: Eric Merritt <[email protected]> >> Date: Wed May 2 10:39:36 2012 -0500 >> >> make eunit detection a bit more robust >> >> commit af8959a33e0c55062d71e4b7c68f2ea3e5714a9c >> Author: Eric Merritt <[email protected]> >> Date: Tue May 1 12:06:50 2012 -0500 >> >> Make sinan version return just the version and nothing more >> >> commit 0ae2a06730fa7a834a819c3cdfd76468ce88cea4 >> Author: Eric Merritt <[email protected]> >> Date: Tue May 1 09:15:56 2012 -0500 >> >> fix version setting problem in makefile >> >> this seems to be related to newer versions of awk, but the fix in this >> patch provides a reasonable solution. >> >> commit cbd2520e2671089d4a3fcb26ebda53a343271273 >> Author: Eric Merritt <[email protected]> >> Date: Tue May 1 08:35:54 2012 -0500 >> >> Fix spec in sinan:run_sinan >> >> commit fbc2d99b17b34138c7553a634e2b0f674c4b71bc >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 15:18:39 2012 -0500 >> >> make sure that solving happens every run >> >> (we cant really know what non-project dependencies changed so we >> should solve each time) >> >> commit d535ddc1980bf267380b7c6449cf36725a7ce88b >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 15:18:14 2012 -0500 >> >> fix recursive copy bug in sin release >> >> commit b81d77756ebae2227b537abbaf0a078c050c43f1 >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 13:50:21 2012 -0500 >> >> make sure that apps with a version in the name are 'discoverable' >> >> commit ec470c0f6cdd83a4f1a7e5dd8e81711c210e78b4 >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 13:04:59 2012 -0500 >> >> fix dist so that it correctly tars the release dir >> >> commit acedbf6291ca9c590ae8a4ee42f1a18877652cfc >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 12:07:28 2012 -0500 >> >> make sure the include_erts is optional in release >> >> commit 91ae619e35bf9c61c8ba856069658deb0ecc08e4 >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 12:07:11 2012 -0500 >> >> remove unneeded param from args in release >> >> commit f01bb0ea9323b15215c920ee8a92726bc23cf1ec >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 12:05:17 2012 -0500 >> >> fix and simplify how 'is_dir_ignorable' works >> >> commit dd5c2f4a6afa3673f024290b43bb93b36019b6fb >> Author: Eric Merritt <[email protected]> >> Date: Mon Apr 30 10:17:49 2012 -0500 >> >> present a more reasonable error message on startup failure >> >> commit aa7aa366d476377652e1096a4aeddb63fcf87fb7 >> Author: Eric Merritt <[email protected]> >> Date: Tue May 1 08:36:31 2012 -0500 >> >> remove built in dependencies on eunit and proper >> >> commit 45cdaba17975737ec29d8b757e70729926360e81 >> Author: Eric Merritt <[email protected]> >> Date: Wed May 2 16:42:28 2012 -0500 >> >> add missing joxa dependency to the system >> >> commit 8da03076b59e510b75532e4ad167f27294120964 >> Author: Eric Merritt <[email protected]> >> Date: Sun Mar 25 10:56:55 2012 -0500 >> >> Remove behaviours from the list of warnings in dialyzer >> >> commit 4a8fe7965135dcfe09830ac507b7aa77ac81abbd >> Author: Eric Merritt <[email protected]> >> Date: Fri Mar 23 20:47:25 2012 -0500 >> >> Add missing joxa to debian control >> >> commit ae17d9ce73c500f95797058095870bc5bd1485e4 >> Author: Eric Merritt <[email protected]> >> Date: Fri Mar 23 20:33:58 2012 -0500 >> >> Add missing version bump to the debian changelog >> >> commit 524898ed33302256c52783fe2bf7184d09fa02ac >> Author: Jordan Wilberding <[email protected]> >> Date: Wed Mar 14 08:48:17 2012 -0400 >> >> Fixed typo. >> >> Signed-off-by: Eric Merritt <[email protected]> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "erlware-dev" group. >> To post to this group, send email to [email protected]. >> To unsubscribe from this group, send email to >> [email protected]. >> For more options, visit this group at >> http://groups.google.com/group/erlware-dev?hl=en. >> > > > > -- > Martin Logan > Erlang & OTP in Action (Manning) http://manning.com/logan > http://twitter.com/martinjlogan > http://erlware.org > > -- > You received this message because you are subscribed to the Google Groups > "erlware-dev" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/erlware-dev?hl=en. > -- You received this message because you are subscribed to the Google Groups "erlware-dev" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/erlware-dev?hl=en.
