Flatten docs hierarchy and branch for 4.4.x docs

[Gert Vanthienen]

L.S.,


With the new Activiti support just committed a few moments ago and
Akka support added a few weeks ago as well, it's time to start
documenting these new features for our upcoming 4.5.0 release.  If
that's OK for people, I would like to create a branch for maintaining
the 4.4.x documentation and start working on the 4.5.x documentation
set in trunk, so we can add information about these new features
there.

Before doing so, I have another proposal: I would also like to flatten
the documentation hierarchy a bit - if you look at
http://servicemix.apache.org/docs/4.4.0/, there you have the
quickstart guide and a JBI guide, but the at the
http://servicemix.apache.org/docs/4.4.0/users-guide/ level, you get
the Camel and NMR guides.  I think it would be better to have them all
in a single overview instead.  I'd rather do that for the current
documentation first, before branching for the next release, so don't
have to manually merge those changes between branches afterwards.


Regards,

Gert Vanthienen
------------------------
FuseSource
Web: http://fusesource.com
Blog: http://gertvanthienen.blogspot.com/

[Freeman-2]

Sounds good,  +1

Freeman
On 2012-6-26, at 下午8:29, Gert Vanthienen wrote:

> L.S.,
>
>
> With the new Activiti support just committed a few moments ago and
> Akka support added a few weeks ago as well, it's time to start
> documenting these new features for our upcoming 4.5.0 release.  If
> that's OK for people, I would like to create a branch for maintaining
> the 4.4.x documentation and start working on the 4.5.x documentation
> set in trunk, so we can add information about these new features
> there.
>
> Before doing so, I have another proposal: I would also like to flatten
> the documentation hierarchy a bit - if you look at
> http://servicemix.apache.org/docs/4.4.0/, there you have the
> quickstart guide and a JBI guide, but the at the
> http://servicemix.apache.org/docs/4.4.0/users-guide/ level, you get
> the Camel and NMR guides.  I think it would be better to have them all
> in a single overview instead.  I'd rather do that for the current
> documentation first, before branching for the next release, so don't
> have to manually merge those changes between branches afterwards.
>
>
> Regards,
>
> Gert Vanthienen
> ------------------------
> FuseSource
> Web: http://fusesource.com
> Blog: http://gertvanthienen.blogspot.com/

---------------------------------------------
Freeman Fang

FuseSource
Email:[hidden email]
Web: fusesource.com
Twitter: freemanfang
Blog: http://freemanfang.blogspot.com
http://blog.sina.com.cn/u/1473905042
weibo: http://weibo.com/u/1473905042

[Jean-Baptiste Onofré]

+1

Very good idea.

Regards
JB

On 06/26/2012 02:29 PM, Gert Vanthienen wrote:

> L.S.,
>
>
> With the new Activiti support just committed a few moments ago and
> Akka support added a few weeks ago as well, it's time to start
> documenting these new features for our upcoming 4.5.0 release.  If
> that's OK for people, I would like to create a branch for maintaining
> the 4.4.x documentation and start working on the 4.5.x documentation
> set in trunk, so we can add information about these new features
> there.
>
> Before doing so, I have another proposal: I would also like to flatten
> the documentation hierarchy a bit - if you look at
> http://servicemix.apache.org/docs/4.4.0/, there you have the
> quickstart guide and a JBI guide, but the at the
> http://servicemix.apache.org/docs/4.4.0/users-guide/ level, you get
> the Camel and NMR guides.  I think it would be better to have them all
> in a single overview instead.  I'd rather do that for the current
> documentation first, before branching for the next release, so don't
> have to manually merge those changes between branches afterwards.
>
>
> Regards,
>
> Gert Vanthienen
> ------------------------
> FuseSource
> Web: http://fusesource.com
> Blog: http://gertvanthienen.blogspot.com/
>

--
Jean-Baptiste Onofré
[hidden email]
http://blog.nanthrax.net
Talend - http://www.talend.com

[Jon Anstey]

+1 Sounds good.

On Tue, Jun 26, 2012 at 9:59 AM, Gert Vanthienen
<[hidden email]>wrote:

> L.S.,
>
>
> With the new Activiti support just committed a few moments ago and
> Akka support added a few weeks ago as well, it's time to start
> documenting these new features for our upcoming 4.5.0 release.  If
> that's OK for people, I would like to create a branch for maintaining
> the 4.4.x documentation and start working on the 4.5.x documentation
> set in trunk, so we can add information about these new features
> there.
>
> Before doing so, I have another proposal: I would also like to flatten
> the documentation hierarchy a bit - if you look at
> http://servicemix.apache.org/docs/4.4.0/, there you have the
> quickstart guide and a JBI guide, but the at the
> http://servicemix.apache.org/docs/4.4.0/users-guide/ level, you get
> the Camel and NMR guides.  I think it would be better to have them all
> in a single overview instead.  I'd rather do that for the current
> documentation first, before branching for the next release, so don't
> have to manually merge those changes between branches afterwards.
>
>
> Regards,
>
> Gert Vanthienen
> ------------------------
> FuseSource
> Web: http://fusesource.com
> Blog: http://gertvanthienen.blogspot.com/
>

--
Cheers,
Jon
---------------
FuseSource
Email: [hidden email]
Web: fusesource.com
Twitter: jon_anstey
Blog: http://janstey.blogspot.com
Author of Camel in Action: http://manning.com/ibsen

[Gert Vanthienen]

L.S.,

I just committed the changes to flatten the docs hierarchy. I'll do a
few more style fixes tomorrow to get the docs pages a bit more aligned
with the main website look and feel before setting up the new
branches.

Regards,

Gert Vanthienen
------------------------
FuseSource
Web: http://fusesource.com
Blog: http://gertvanthienen.blogspot.com/


On Wed, Jun 27, 2012 at 8:39 PM, Jon Anstey <[hidden email]> wrote:

> +1 Sounds good.
>
> On Tue, Jun 26, 2012 at 9:59 AM, Gert Vanthienen
> <[hidden email]>wrote:
>
>> L.S.,
>>
>>
>> With the new Activiti support just committed a few moments ago and
>> Akka support added a few weeks ago as well, it's time to start
>> documenting these new features for our upcoming 4.5.0 release.  If
>> that's OK for people, I would like to create a branch for maintaining
>> the 4.4.x documentation and start working on the 4.5.x documentation
>> set in trunk, so we can add information about these new features
>> there.
>>
>> Before doing so, I have another proposal: I would also like to flatten
>> the documentation hierarchy a bit - if you look at
>> http://servicemix.apache.org/docs/4.4.0/, there you have the
>> quickstart guide and a JBI guide, but the at the
>> http://servicemix.apache.org/docs/4.4.0/users-guide/ level, you get
>> the Camel and NMR guides.  I think it would be better to have them all
>> in a single overview instead.  I'd rather do that for the current
>> documentation first, before branching for the next release, so don't
>> have to manually merge those changes between branches afterwards.
>>
>>
>> Regards,
>>
>> Gert Vanthienen
>> ------------------------
>> FuseSource
>> Web: http://fusesource.com
>> Blog: http://gertvanthienen.blogspot.com/
>>
>
>
>
> --
> Cheers,
> Jon
> ---------------
> FuseSource
> Email: [hidden email]
> Web: fusesource.com
> Twitter: jon_anstey
> Blog: http://janstey.blogspot.com
> Author of Camel in Action: http://manning.com/ibsen