Thanks to the hard work of Samson and Mark the new doc formats on the Seam 2.0 branch are almost there. Please checkout the Seam_2_0 branch from Seam svn (https://svn.jboss.org/repos/seam/branches/Seam_2_0) and build the docs using: ant refdoc The docs are built into doc/Seam_Reference_Guide/target/docbook/publish/en-US The PDF, html and html_single have the SeamFramework.org style applied (the html one uses graphics from SeamFramework.org, the pdf just the font colours). Andy, James - I would appreciate your review of this as I'm no graphic artist! There is also code highlighting for XML and Java code (all the code blocks need the role="JAVA" or role="XML" attributes applied to make the highlight appear, so as you edit docs please add this). TODO: * All the maven plugins need to be releases (they are all snapshot currently), and I'll work with Mark on that over the next few days. * The "callouts" are overflowing in the PDF version * The "callouts" with code highlighting aren't placing the annotations correctly in the HTML versions Thanks again, Pete -- Pete Muir http://in.relation.to/Bloggers/Pete http://www.seamframework.org _______________________________________________ seam-dev mailing list seam-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/seam-dev

Are we clear to go through and update for code styles?

Should those changes only go into truck, or are we going to attempt to merge the changes from 2.0 branch?

Hey Pete, I've created a JIRA task for this: http://jira.jboss.com/jira/browse/ORG-44 Cheyenne Weaver is currently working on this to integrate the SFWK.org look and feel into the DocBook styles. She's replacing a good portion of the standard DocBook graphics in the process and leveraging the work we've done on the JBoss.org community styled DocBooks. James On Mar 19, 2008, at 1:05 PM, Pete Muir wrote: On 19 Mar 2008, at 18:00, Jay Balunas wrote: Are we clear to go through and update for code styles? Please do. Should those changes only go into truck, or are we going to attempt to merge the changes from 2.0 branch? Trunk is still using the old style docs, and I don't know how Samson intends to the conversion for trunk. I suspect the easiest thing to do will be to take the branch point for Samson's change's, diff it against current trunk, copy the branched docs into trunk, and apply the diff with the content changes. If we adopt this strategy, then we should do all cosmetic changes in the branch. ___________________________________ James Cobb JBoss Labs / jboss.org UI Design Lead [ AIM/Yahoo/Skype: insectengine ::: 512-652-5867 ]

Guys and gals, The documentation looks great! I love the consistent look and feel and the code blocks especially appear very attractive and inviting. This is certainly a landmark moment in the maturation of this project. Quoting my wife, "It looks so professional and clean." I agree. -Dan On Tue, Mar 25, 2008 at 12:10 PM, Pete Muir <pmuir(a)bleepbleep.org.uk&gt; wrote: > Thanks James! > > I've added a couple of notes to the JIRA issue as you probably saw. > > Cheyenne - do you have an idea when you will be able to look at this? > This will allow us to see whether we should delay the next release of > Seam to include any changes you make or not... > > > > On 25/03/2008, James Cobb <jcobb(a)redhat.com&gt; wrote: > > Hey Pete, > > > > I've created a JIRA task for this: > > http://jira.jboss.com/jira/browse/ORG-44 > > > > Cheyenne Weaver is currently working on this to integrate the SFWK.org look > > and feel into the DocBook styles. She's replacing a good portion of the > > standard DocBook graphics in the process and leveraging the work we've done > > on the JBoss.org community styled DocBooks. > > > > James > > > > > > > > > > On Mar 19, 2008, at 1:05 PM, Pete Muir wrote: > > > > > > On 19 Mar 2008, at 18:00, Jay Balunas wrote: > > > > > > Are we clear to go through and update for code styles? > > > > Please do. > > > > > > Should those changes only go into truck, or are we going to attempt to merge > > the changes from 2.0 branch? > > > > Trunk is still using the old style docs, and I don't know how Samson intends > > to the conversion for trunk. > > > > I suspect the easiest thing to do will be to take the branch point for > > Samson's change's, diff it against current trunk, copy the branched docs > > into trunk, and apply the diff with the content changes. If we adopt this > > strategy, then we should do all cosmetic changes in the branch. > > > > > > ___________________________________ > > > > James Cobb > > JBoss Labs / jboss.org UI Design Lead > > > > [ AIM/Yahoo/Skype: insectengine ::: 512-652-5867 ] > > > > > > > > > > > -- > > Pete Muir > http://in.relation.to/Bloggers/Pete > http://www.seamframework.org > _______________________________________________ > > > seam-dev mailing list > seam-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/seam-dev >

On 19/03/2008, Pete Muir <pmuir(a)bleepbleep.org.uk&gt; wrote: > > TODO: > > * All the maven plugins need to be releases (they are all snapshot > currently), and I'll work with Mark on that over the next few days. > * The "callouts" are overflowing in the PDF version I fixed this by removing the <example> tag which caused the problem