Mailing-List: contact dev-help@ignite.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@ignite.apache.org
MIME-Version: 1.0
In-Reply-To: <CA+0=VoWm_uYT0sRp9hjRiLu+cRofYT0nJJ3BT9s7pNAz5WYtgg@mail.gmail.com>
References: <CAABS=BPRBtaUEokhpUyDWMjnA0T8+GnJ=WYqJftiDBadXDcamw@mail.gmail.com>
 <2DE7FB3A-BBE6-4FB3-ABF4-439CA1CB499E@gridgain.com> <CA+0=VoWm_uYT0sRp9hjRiLu+cRofYT0nJJ3BT9s7pNAz5WYtgg@mail.gmail.com>
From: Prachi Garg <pgarg@gridgain.com>
Date: Thu, 25 Aug 2016 10:24:06 -0700
Message-ID: <CAABS=BPipo_tOYxDRE2od_gMEQj-5kazBG5fN00qi1QAeO8f+A@mail.gmail.com>
Subject: Re: Maintaining documentation consistency on readme.io
To: dev@ignite.apache.org
Content-Type: multipart/alternative; boundary=001a114aa8d00c3dc8053ae8ac17
archived-at: Thu, 25 Aug 2016 17:24:48 -0000

--001a114aa8d00c3dc8053ae8ac17
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Changes to the existing pages will still have to be copied manually; but
since we are not maintaining two versions (current and future) at the same
time, it may be a lesser overhead. Once a new version is released, we
hardly go back to the previous versions to fix anything.

-P

On Wed, Aug 24, 2016 at 9:42 PM, Dmitriy Setrakyan <dsetrakyan@apache.org>
wrote:

> Prarchi, great idea. We should follow it.
>
> However, this addresses only new content. What about changes to the
> existing pages?
>
> D.
>
> On Wed, Aug 24, 2016 at 5:15 PM, Denis Magda <dmagda@gridgain.com> wrote:
>
> > Prachi,
> >
> > This is an excellent idea!
> >
> > Would you mind adding a new page to this [1] section?
> >
> > After the page is ready we also need to leave a reference to it under
> this
> > [2] section.
> >
> > [1] https://cwiki.apache.org/confluence/display/IGNITE/
> Development+Process
> > <https://cwiki.apache.org/confluence/display/IGNITE/Development+Process=
>
> > [2] https://cwiki.apache.org/confluence/display/IGNITE/How+
> > to+Contribute#HowtoContribute-Documentation&examples <
> > https://cwiki.apache.org/confluence/display/IGNITE/How+
> > to+Contribute#HowtoContribute-Documentation&examples>
> >
> > =E2=80=94
> > Denis
> >
> > > On Aug 24, 2016, at 10:58 AM, Prachi Garg <pgarg@gridgain.com> wrote:
> > >
> > > Igniters,
> > >
> > > Since readme.io does not automatically copy the changes from the
> current
> > > version to the subsequent version, I have the following suggestion:
> > >
> > > Create the document for future releases within the document for the
> > current
> > > version, and keep the pages hidden. After the new release, create the
> new
> > > version for the document and unhide the pages.
> > >
> > > This way we don't have to manually copy the document between the two
> > > versions.
> > >
> > > Thoughts?
> > >
> > > -Prachi
> >
> >
>

--001a114aa8d00c3dc8053ae8ac17--