Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (nike.apache.org: domain of kxepal@gmail.com designates
 74.125.82.169 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAEkz3Nyg+gfz8=VGbccAfc5GwqOZ+FU+AFdbFYDaKqVzz6Apdg@mail.gmail.com>
References: 
 <CAEkz3Nw4=sMw=5meXKv545iJ67ACnVcHiKxDSkEbaGBx1ggWCw@mail.gmail.com>
	<CAL+Y1nuZXeO2sYRRQNKXnvmPzHWFXavpXxL_tbWDw-K0uQwEhw@mail.gmail.com>
	<CAKmKYaC5YFo8Q6t2yK5M-GX_K0Uh-CkA-_+=e1QG0jM5-h9nMw@mail.gmail.com>
	<CAEkz3Nx-VkZUgro=91-6u8ZUd3qN2C18-jxw7d1N=Z_9GoEr2A@mail.gmail.com>
	<CAKmKYaA7X7w-n4jyy+TStzND6z+tMjAJGrxg6+DL2tK8nQaCQA@mail.gmail.com>
	<CAL+Y1nsHkGePbr23b0UBXz=r_UTdm0qRVUao_r1btaW6LBN6Yw@mail.gmail.com>
	<CAPaJBx57V9K3hXyNmAuhoFmruV204pdmvaF=t-a6QH4gXe-ASQ@mail.gmail.com>
	<CAEkz3NxWYgqJn-D_fzur6QGNw3ZxMYbYRRoZ8MN4My+EkS1N+Q@mail.gmail.com>
	<CAPaJBx7T6H0PwrvLE-3qXV_b=SMRcHuiD8EZ_by2hHUf8cZa2w@mail.gmail.com>
	<CAEkz3NyUdZYTHGmWSu7mRQ5UhcgHSzR4cMjq=LvPE++f21KvKg@mail.gmail.com>
	<CAPaJBx6u6AgNyXRxQN3E_N_XdiqonO3ow7BfnuyZRYhfF8eeRQ@mail.gmail.com>
	<CAHdjipL5pbQ1nMDu+3myzwpVTmGNzD7vpWdHyoiQkUkN1kftuw@mail.gmail.com>
	<CAPaJBx75Ty_p8YRbJr9cnwHfQxfmB7RTVNTAKNSLCD_gyyLdKw@mail.gmail.com>
	<CAEkz3Nyg+gfz8=VGbccAfc5GwqOZ+FU+AFdbFYDaKqVzz6Apdg@mail.gmail.com>
Date: Sat, 10 Aug 2013 19:12:57 +0400
Message-ID: 
 <CAHdjip+psasAA+=kpW6mzh-_gCSrK4kMoTsFoO++tZ9AAzqb8Q@mail.gmail.com>
Subject: Re: Project proposal for ICFOSS
From: Alexander Shorin <kxepal@gmail.com>
To: Yashin Mehaboobe <yashinm92@gmail.com>
Cc: "dev@couchdb.apache.org" <dev@couchdb.apache.org>,
 Noah Slater <nslater@apache.org>,
	Dirkjan Ochtman <djc.ochtman@gmail.com>, Dave Cottlehuber <dch@jsonified.com>
Content-Type: text/plain; charset=UTF-8

On Sat, Aug 10, 2013 at 1:34 PM, Yashin Mehaboobe <yashinm92@gmail.com> wrote:
>
> Alexander: I was thinking of starting to create the RST file from current
> release only. From now on, a unique file will be created for each branch
> release (with the commit hash/version as the name?).

Is this structure is ok for you?
https://github.com/apache/couchdb/tree/1781-reorganize-and-improve-docs/share/doc/src/whatsnew

It's per release branch however, but should be more easy to inject new
release changes.

> About the integration of upgrade notes and CVE warnings into the file,
> could you please suggest from where I can pull the data? Is it usually
> present in the Git repository or the JIRA?

Probably, there is no such source to pull from. CVE information
theoretically could be found at
http://cve.mitre.org/cgi-bin/cvename.cgi
but they still has no info about three latest issues: 2012-5641,
2012-5649 and 2012-5650.

AFAIK, CVE issues are announces at dev@ and security@ (?) mailing
lists. Also I'd put them at:
https://github.com/apache/couchdb/tree/1781-reorganize-and-improve-docs/share/doc/src/cve

However, I'm not sure how you plan to parse such data.

Upgrade noted still have to be written manually since only devs and
testers are knows what have changes and what actions are needed to
upgrade CouchDB to the newest release, so generated file with changes
have to be placed under version control - that's how I see the problem
and solution, but there may be others.

--
,,,^..^,,,