If I'm not mistaken, both Python and scipy keep their docs in a separate repo.
Another challenge with our release notes is that we tend to have a *lot* of changes per release, thanks to both the rate at which we release, and the large amount of code we have coming in from GSoC (plus a lot of smaller contributions from various people). The release notes should do a good job of summarizing the high-level changes for the release as well as list all changes for anyone who's interested. I do agree that our release notes should be improved. I'm just not convinced that moving them to the source would solve that. Aaron Meurer On Sat, Nov 22, 2014 at 4:40 PM, Sergey B Kirpichev <skirpic...@gmail.com> wrote: > On Sat, Nov 22, 2014 at 02:24:05PM -0600, Aaron Meurer wrote: >> I still prefer having the release notes in the wiki. It makes it >> easier for people to change them > > Unfortunately, this doesn't work: > #2782 - not mentioned > #2927 - fixes #7145 > #7300 - small change, but... > #2992 - two bug fixed > #7296 - not mentioned > > Just five lines from > git log --merges sympy-0.7.5..sympy-0.7.6 --oneline > >> What are the benefits of having them in the main repo? Note that the >> wiki is under revision control (git clone >> g...@github.com:sympy/sympy.wiki.git). > > 1) No omissions and (hopefully) less mistakes (due to automation) > 2) Less work. > 3) People expect this (see other projects on scipy.org, or > python.org - "what's new" is a part of the documentation). > 4) Distibutions expect this (e.g. Debian has lintian warning about > missing upstream changelog file). > > The price is low: instead of just pushing commit button - > committer should add a human-readable note and some labels. > > Another variant - we could gather changelog entry from the PR > description. It's editable in any time by PR author or any > collaborator. > > Scripting all this should be trivial. > > -- > You received this message because you are subscribed to the Google Groups > "sympy" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to sympy+unsubscr...@googlegroups.com. > To post to this group, send email to sympy@googlegroups.com. > Visit this group at http://groups.google.com/group/sympy. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sympy/20141122224034.GA1943%40darkstar.order.hcn-strela.ru. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "sympy" group. To unsubscribe from this group and stop receiving emails from it, send an email to sympy+unsubscr...@googlegroups.com. To post to this group, send email to sympy@googlegroups.com. Visit this group at http://groups.google.com/group/sympy. To view this discussion on the web visit https://groups.google.com/d/msgid/sympy/CAKgW%3D6JBGDTmQh5P10x%2BTEbUzeCEwMe%3Dv9atfXVo4o1uTB9jkA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.