Mailing-List: contact gora-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: gora-dev@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of lewis.mcgibbney@gmail.com
 designates 74.125.82.43 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAMUu0w8JsJakcmKs5H6ZSFRrFsrB37WQvKuPAHsd+dMB682LAA@mail.gmail.com>
References: 
 <CAGaRif3-KZojnqiC61d5+5Ns_BswCU+zcaiHjd2GeGMDnkht-w@mail.gmail.com>
	<CAMUu0w_zLoDKCwbVpnKNPPf3dX_8HE9j55tUdDwZv81gY7PPfg@mail.gmail.com>
	<CAGaRif2CHchYX80kjqXj08t4Kdbcm3wQDQpp5Do=w8ORqF6bYg@mail.gmail.com>
	<CAMUu0w8JsJakcmKs5H6ZSFRrFsrB37WQvKuPAHsd+dMB682LAA@mail.gmail.com>
Date: Tue, 3 Jan 2012 22:14:05 +0000
Message-ID: 
 <CAGaRif1m9ygeW_brzchsvC7Wu==FdCSH4Kan8aK4be9ef8Q2Og@mail.gmail.com>
Subject: Re: Gora site docs
From: Lewis John Mcgibbney <lewis.mcgibbney@gmail.com>
To: gora-dev@incubator.apache.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Hi Enis,

It would be great to sort this out shortly after we hear the
Graduation outcome, I am happy to work towards addressing all of the
open documentation Jira issues under this umbrella issue, however I'm
also of the opinion that we should make life as easy as possible to
work with the documentation.

In addition, depending on the outcome of the Graduation, we will
probably need to revamp the entire Gora site docs anyway. Having read
the link you provided, my own opinion is weighted towards migrating to
the new CMS proposed. Although this means a bit more work initially,
it will also mean that we are able to begin afresh and really get on
top of it.

Does anyone on the team have any experience migrating content to the
new CMS? I know a couple of people I can get in touch with to get up
to speed with this but it would be great to hear some input from the
wider Gora dev team.

Thanks for now

Lewis


On Wed, Dec 28, 2011 at 8:29 PM, Enis S=F6ztutar <enis.soz@gmail.com> wrote=
:
> Hi Lewis,
>
> I guess, the links to the release-specific docs are broken, due to the ne=
w
> svnpubsub script releasing the changes to the site. The easiest way I thi=
nk
> is to commit the 0.1.1 release docs under /site/docs/r0.1.1-incubating/ a=
nd
> point /current to it.
>
> Another option can be to switch to Maven for building the site docs, or u=
se
> the confluence wiki as our main web page, and move all the current conten=
t
> there.
>
> see https://www.apache.org/dev/cms.html
>
> Thanks,
> Enis
>
> On Tue, Dec 27, 2011 at 9:13 AM, Lewis John Mcgibbney <
> lewis.mcgibbney@gmail.com> wrote:
>
>> Hi Guys,
>>
>> Whilst addressing GORA-71, it has been drawn to my attention that the
>> link to the per-release docs [1] is broken!
>>
>> Any ideas what is wrong?
>>
>> Thanks
>>
>> Lewis
>>
>> [1] https://svn.apache.org/viewvc/incubator/gora/trunk/docs/
>>
>> On Thu, Oct 27, 2011 at 1:14 AM, Enis S=F6ztutar <enis.soz@gmail.com> wr=
ote:
>> > Hi Lewis,
>> >
>> > The site docs at Gora are in two places, release independent docs are =
at
>> > [1], and per-release docs are at [2]. The reasoning is that, the
>> per-release
>> > docs contain the release-specific information (like Javadoc, tutorial,
>> etc),
>> > and this documentation is distributed at the tar ball, and everyone
>> should
>> > be able to build and use the docs locally. Release independent docs
>> contain
>> > the regular site information.
>> >
>> > So, with that said, the release-independent docs are deployed at the r=
oot
>> > directory (http://i.a.o/gora/), and every release doc should go under
>> it's
>> > release number (like http://i.a.o/gora/docs/r0.1-incubating/), and
>> finally,
>> > docs for trunk goes under http://i.a.o/gora/docs/current/. For
>> deploying the
>> > site at people.apache.org, we just check out rendered pages at [1], an=
d
>> > check out [2] under /docs/current/ and for each release, we create a
>> > directory under /docs/, and check out the docs for that release, so th=
at
>> the
>> > site contains /docs/current/, /docs/r0.1-incubating,
>> > /docs/r0.1.1-incubating, etc.
>> >
>> > [1] https://svn.apache.org/viewvc/incubator/gora/site/
>> > [2] https://svn.apache.org/viewvc/incubator/gora/trunk/docs/
>> >
>> > Coming to your question, the references that you asked about in forres=
t
>> for
>> > the release-independent docs are links to per-release docs under [2].
>> >
>> > Hope this answers your question. Let me know otherwise.
>> > Enis
>> >
>> > On Wed, Oct 26, 2011 at 1:51 PM, lewis john mcgibbney <
>> > lewis.mcgibbney@gmail.com> wrote:
>> >
>> >> Hi,
>> >>
>> >> I think this is aimed mainly towards Enis but I'm not sure, can someo=
ne
>> >> please tell me where I can find the following
>> >>
>> >> =A0 =A0<docs href=3D"http://incubator.apache.org/gora/docs/">
>> >> =A0 =A0 =A0<current href=3D"current/">
>> >> =A0 =A0 =A0 =A0<index href=3D"index.html"/>
>> >> =A0 =A0 =A0 =A0<quickstart href=3D"quickstart.html"/>
>> >> =A0 =A0 =A0 =A0<gora-core href=3D"gora-core.html"/>
>> >> =A0 =A0 =A0 =A0<gora-cassandra href=3D"gora-cassandra.html"/>
>> >> =A0 =A0 =A0 =A0<gora-hbase href=3D"gora-hbase.html"/>
>> >> =A0 =A0 =A0 =A0<gora-sql href=3D"gora-sql.html"/>
>> >> =A0 =A0 =A0</current>
>> >> =A0 </docs>
>> >>
>> >> Just so I can begin working on upgrading the missing site docs as per
>> the
>> >> Jira tickets I filed a while ago (and forgot about).
>> >>
>> >> Thank you
>> >>
>> >> --
>> >> *Lewis*
>> >>
>>
>>
>>
>> --
>> Lewis
>>


--=20
Lewis