On Sat, Jul 13, 2013 at 2:35 AM, Ryan Ollos <[email protected]> wrote:
> On Fri, Jul 12, 2013 at 9:01 AM, Olemis Lang <[email protected]> wrote: > >> On 7/12/13, Ryan Ollos <[email protected]> wrote: >> > On Fri, Jul 12, 2013 at 2:53 AM, Branko Čibej <[email protected]> >> wrote: >> > >> >> On 12.07.2013 01:48, Ryan Ollos wrote: >> >> > Adding the issue to the release notes will require creating a new >> >> release, >> >> >> >> If that's the case, then we're doing something wrong. Release notes >> >> should not be part of the release tarball -- that should contain a >> >> /link/ to the release notes, so that any errata can be applied to the >> >> "live" release notes. >> >> >> >> Subversion keeps release notes in the project site repository. BH could >> >> have wiki pages with release notes -- only editable by committers, of >> >> course. >> >> >> >> -- Brane >> >> >> > >> > Keeping release notes on the wiki sounds good to me. >> > >> >> fwiw + >> >> > On a related note, at some point we should do something about our >> diverging >> > installation instructions on the wiki (1) and in the repository (2). I >> vote >> > for using the wiki in this case as well. This was recently brought to >> our >> > attention again by a user (3). >> > >> > >> > (1) https://issues.apache.org/bloodhound/wiki/BloodhoundInstall >> > (2) >> http://svn.apache.org/repos/asf/bloodhound/trunk/installer/README.rst >> > (3) http://markmail.org/message/pa6go7siozxtouje >> > >> >> There's a recent conversation in trac-users ML that seems to be related >> to this >> >> http://www.gossamer-threads.com/lists/trac/users/51772?page=last >> http://www.gossamer-threads.com/lists/trac/users/51804 > > > If everyone agrees to keeping the ReleaseNotes on the wiki, the next steps > are: > [...] > I also propose to merge any significant and relevant differences between README.rst in the repository and the BloodhoundInstall wiki page into the BloodhoundInstall wiki page, so that we have a single source of documentation. The file in the repository can point to the wiki page, as we propose to do for the ReleaseNotes. I'll wait until later this week before starting on any of these changes. Please try to raise any issues or alternative ideas you have before then.
