L.S., When we created the new website, we did go over everything and copied the things that were relevant for both versions of ServiceMix to the new website. For the documentation pages, we didn't have that much useful information for ServiceMix 4 so we just created those from scratch. We could recreate a similar documentation base for ServiceMix 3.x as well by copying over content from the old website, but I'm not sure it's worth the effort. If we ensure people get pointed back to the ServiceMix 4 docs all the time, I'd rather leave those legacy pages where they are and focus on adding more content to our newer docs instead.
There's a lot of stuff we could/should add to the Camel guide and we don't even have a CXF guide yet. Another thing we might want to do, is also add a notice to the new JBI guide (at http://servicemix.apache.org/docs/4.4.0/jbi/index.html), e.g. pointing to the http://servicemix.apache.org/docs/4.4.0/users-guide/getting-started/technology-selection.htmlpage and improving the latter page to ensure people pick the right technology mix. Anyone in for a doc hackathon week? Regards, Gert Vanthienen ------------------------ FuseSource Web: http://fusesource.com Blog: http://gertvanthienen.blogspot.com/ On Sat, May 26, 2012 at 9:40 AM, Claus Ibsen <[email protected]> wrote: > On Fri, May 25, 2012 at 10:14 PM, Gert Vanthienen > <[email protected]> wrote: > > L.S., > > > > > > On our website home page at http://servicemix.apache.org/, we currently > > have a notice that allows people to navigate to the previous website > > (mostly because it still contains a lot of information about ServiceMix > > 3.x). However, I think we should also have a similar box (or probably > even > > the yellow/warning alternative) on all the pages on > > http://servicemix.apache.org/old and below, pointing back to the new > > ServiceMix 4.x based main website. From some questions on the mailing > > lists, it looks like people are landing on these older pages and never > even > > realize we have a newer version/website/documentation set available too. > > > > Also, there are quite a few pages left in the website that were exported > by > > confluence but never got removed when we move to our new Scalate-based > > website, e.g. http://servicemix.apache.org/servicemix-http.html is an > > example of such a page. As you see, they really don't look good - there > > are no more links on the website that are pointing to these pages, but > > Google still digs them up if you do searches. I would propose we just > > manually remove all those left-over pages from the website and then > > regenerate both the contents from servicemix.apache.org and > > servicemix.apache.org to ensure we only have the contents out there > that we > > really intend to have. > > > > Well spotted. Good idea to cleanup this, and refer people to the 4.x site. > +1 > > And maybe add a JIRA ticket about going over the old content from 3.x, and > copy > the useable bits to the 4.x site. > > > > > > Regards, > > > > Gert Vanthienen > > ------------------------ > > FuseSource > > Web: http://fusesource.com > > Blog: http://gertvanthienen.blogspot.com/ > > > > -- > Claus Ibsen > ----------------- > CamelOne 2012 Conference, May 15-16, 2012: http://camelone.com > FuseSource > Email: [email protected] > Web: http://fusesource.com > Twitter: davsclaus, fusenews > Blog: http://davsclaus.blogspot.com/ > Author of Camel in Action: http://www.manning.com/ibsen/ >
