Yay, just what I needed :). I will start making changes to the other components.
Thanks, Hadrian On Apr 1, 2011, at 3:03 PM, Stan Lewis wrote: > +1 that looks way better... > > On Thu, Mar 31, 2011 at 10:10 PM, Hadrian Zbarcea <hzbar...@gmail.com> wrote: >> I made to changes from the original version [v99]. In [v100] I consolidated >> the columns are proposed before. In the current [v101] version I changed the >> order of the columns to Name | Required | description and consolidated the >> Description + Default Value + Example together. I believe the latter to be a >> better choice (it also renders better). This is what I intend to use going >> forward, if no objections. >> >> Hadrian >> >> [v99] - >> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=26117054 >> [v100] - >> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=26117057 >> [v101] - >> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=52098 >> >> >> On Mar 31, 2011, at 8:43 PM, Hadrian Zbarcea wrote: >> >>> Aside from the generation during release:prepare issue [1], for which I >>> have to do some more releases and drop the artifacts to figure out (unless >>> somebody has a better idea), I looked at the rendered pdf manual [2] and a >>> few things look horrific. In particular the Components page [3] is so wide >>> it doesn't fit into the screen and the table based documentation of the uri >>> arguments/options is not consistent in many cases, missing in some and >>> spans across 5 columns (like in the CXF component [4] case) which again, >>> renders very bad. >>> >>> I intend to spend some time in the next week cleaning up the docs a bit and >>> I propose a 3 column based format: >>> Name | Descriptions | Required >>> consolidating the Description and Example columns (having the example part >>> at the end of the description, and consolidation the Required and Default >>> Value columns (if Required is Yes, there is no default value, so in many >>> cased that column is empty anyway, just taking space unnecessarily). >>> >>> I will make changes to the CXF page [4] in the next hour or so and give an >>> example of what I mean (you can see a diff from the previous version). If >>> you have a better idea please shout. Once we agree on a format I can go >>> ahead and try to make it consistent and complete across all components. >>> >>> Cheers, >>> Hadrian >>> >>> [1] https://issues.apache.org/jira/browse/CAMEL-3774 >>> [2] http://camel.apache.org/manual/camel-manual-2.7.0.pdf >>> [3] https://cwiki.apache.org/confluence/display/CAMEL/Components >>> [4] https://cwiki.apache.org/confluence/display/CAMEL/CXF >> >>
