[seam-dev] Bundled distribution documentation

Jason Porter lightguard.jp at gmail.com
Thu Sep 1 19:32:36 EDT 2011


Catch should be fine.

On Thu, Sep 1, 2011 at 17:31, George Gastaldi <gegastaldi at gmail.com> wrote:

> Hi Shane,
>
> I still couldn't review the docs on Seam Reports, so I guess thats a nay
> for me.
>
> Regards,
>
> George
>
> Em 01/09/2011, às 20:15, Shane Bryzak <sbryzak at redhat.com> escreveu:
>
> > Guys, I need a yea or nay on this for your module.
> >
> > On 31/08/11 14:14, Shane Bryzak wrote:
> >> Module leads,
> >>
> >> Can you please review the list below and confirm that the documentation
> >> chapters are correct for your module.  Also, I would like everyone to
> >> take a moment to review the module documentation guidelines, as there
> >> were a number of breakages in the bundled documentation build because
> >> the guidelines weren't adhered to, particularly in the new modules for
> >> Seam 3.1:
> >>
> >> 1) Always prefix the filenames of your documentation chapters with the
> >> name of your module.  E.g. security-authentication.xml,
> >> security-authorization.xml, etc.
> >>
> >> 2) Whenever you assign an ID to a docbook element, such as a<chapter>
> >> or<section>, ALWAYS prefix the id with your module name.  For example,
> >> <chapter id="security-introduction">  or<section
> >> id="security-getting-started">.  As all of the chapters for all modules
> >> are combined when building the bundled documentation, all IDs must be
> >> unique.  This is a particularly time consuming problem to fix because
> >> the error output from the Maven docbook plugin doesn't tell you which
> >> files are the problem ones.
> >>
> >> 3) When adding, renaming or deleting a chapter of your documentation,
> >> please notify me of the changes so that I can update
> >> bundled_master.xml.  This file must be manually kept up to date whenever
> >> any documentation changes are made.
> >>
> >> Thanks,
> >> Shane
> >>
> >>
> >> <?xml version='1.0' encoding="utf-8"?>
> >> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> >>     "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"  [ ]>
> >> <book lang="en" xmlns:xi="http://www.w3.org/2001/XInclude">
> >>
> >> <toc />
> >>
> >> <title>Seam 3</title>
> >> <subtitle>Bundled Reference Guide</subtitle>
> >>
> >> <xi:include href="bundled_credits.xml"/>
> >> <xi:include href="bundled_intro.xml"/>
> >>
> >> <part>
> >> <title>Forge</title>
> >> <xi:include href="forge-preface.xml" />
> >> <xi:include href="forge-installation.xml" />
> >> <xi:include href="forge-creating-basic-webapp.xml" />
> >> <xi:include href="forge-plugin-dev.xml" />
> >> </part>
> >>
> >> <part>
> >> <title>Seam Solder</title>
> >> <xi:include href="solder-preface.xml"/>
> >> <xi:include href="solder-gettingstarted.xml"/>
> >> <xi:include href="solder-programmingmodel.xml"/>
> >> <xi:include href="solder-annotationliterals.xml"/>
> >> <xi:include href="solder-elextensions.xml"/>
> >> <xi:include href="solder-resourceloading.xml"/>
> >> <xi:include href="solder-logging.xml"/>
> >> <xi:include href="solder-typeutilities.xml"/>
> >> <xi:include href="solder-beanmanagerprovider.xml"/>
> >> <xi:include href="solder-beanutilities.xml"/>
> >> <xi:include href="solder-properties.xml"/>
> >> <xi:include href="solder-unwraps.xml"/>
> >> <xi:include href="solder-defaultbeans.xml"/>
> >> <xi:include href="solder-genericbeans.xml"/>
> >> <xi:include href="solder-servicehandler.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Configuration</title>
> >> <xi:include href="config-introduction.xml"/>
> >> <xi:include href="config-xml-provider.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Persistence</title>
> >> <xi:include href="persistence-general.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Transaction</title>
> >> <xi:include href="transaction-general.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Servlet</title>
> >> <xi:include href="servlet-introduction.xml"/>
> >> <xi:include href="servlet-installation.xml"/>
> >> <xi:include href="servlet-events.xml"/>
> >> <xi:include href="servlet-injectable_refs.xml"/>
> >> <xi:include href="servlet-exception_handling.xml" />
> >> <xi:include href="servlet-beanmanager.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Security</title>
> >> <xi:include href="security-introduction.xml"/>
> >> <xi:include href="security-authentication.xml"/>
> >> <xi:include href="security-identitymanagement.xml"/>
> >> <xi:include href="security-authentication-external.xml"/>
> >> <xi:include href="security-authorization.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam International</title>
> >> <xi:include href="international-preface.xml" />
> >> <xi:include href="international-installation.xml" />
> >> <xi:include href="international-locales.xml" />
> >> <xi:include href="international-timezones.xml" />
> >> <xi:include href="international-messages.xml" />
> >> </part>
> >>
> >> <part>
> >> <title>Seam Faces</title>
> >> <xi:include href="faces-preface.xml" />
> >> <xi:include href="faces-installation.xml" />
> >> <xi:include href="faces-events.xml" />
> >> <xi:include href="faces-scopes.xml" />
> >> <xi:include href="faces-messages.xml" />
> >> <xi:include href="faces-artifacts.xml" />
> >> <xi:include href="faces-components.xml" />
> >> </part>
> >>
> >> <part>
> >> <title>Seam Catch</title>
> >> <xi:include href="catch-introduction.xml"/>
> >> <xi:include href="catch-installation.xml"/>
> >> <xi:include href="catch-client_usage.xml"/>
> >> <xi:include href="catch-advanced_usage.xml"/>
> >> <xi:include href="catch-integration.xml"/>
> >> <xi:include href="catch-glossary.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Reports</title>
> >> <xi:include href="reports-preface.xml" />
> >> <xi:include href="reports-installation.xml" />
> >> <xi:include href="reports-usage.xml" />
> >> </part>
> >>
> >> <part>
> >> <title>Seam Remoting</title>
> >> <xi:include href="remoting-general.xml"/>
> >> <xi:include href="remoting-model.xml"/>
> >> <xi:include href="remoting-validation.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam REST</title>
> >> <xi:include href="rest-preface.xml" />
> >> <xi:include href="rest-installation.xml" />
> >> <xi:include href="rest-exception-mapping.xml" />
> >> <xi:include href="rest-validation.xml" />
> >> <xi:include href="rest-templating.xml" />
> >> <xi:include href="rest-client.xml" />
> >> <xi:include href="rest-dependencies.xml" />
> >> </part>
> >>
> >> <part>
> >> <title>Seam JCR</title>
> >> <xi:include href="jcr-introduction.xml" />
> >> <xi:include href="jcr-modeshape.xml"/>
> >> <xi:include href="jcr-jackrabbit.xml"/>
> >> <xi:include href="jcr-event-mapping.xml"/>
> >> <xi:include href="jcr-ocm.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam JMS</title>
> >> <xi:include href="jms-intro.xml" />
> >> <xi:include href="jms-installation.xml" />
> >> <xi:include href="jms-resource-injection.xml" />
> >> <xi:include href="jms-messaging.xml" />
> >> <xi:include href="jms-routing.xml" />
> >> <xi:include href="jms-mapping-interfaces.xml" />
> >> </part>
> >>
> >> <part>
> >> <title>Seam Validation</title>
> >> <xi:include href="validation-introduction.xml"/>
> >> <xi:include href="validation-installation.xml"/>
> >> <xi:include href="validation-dependency-injection.xml"/>
> >> <xi:include href="validation-method-validation.xml"/>
> >> </part>
> >>
> >> <part>
> >> <title>Seam Wicket</title>
> >> <xi:include href="wicket-preface.xml" />
> >> <xi:include href="wicket-installation.xml" />
> >> <xi:include href="wicket-features.xml" />
> >> </part>
> >>
> >> </book>
> >> _______________________________________________
> >> seam-dev mailing list
> >> seam-dev at lists.jboss.org
> >> https://lists.jboss.org/mailman/listinfo/seam-dev
> >
> > _______________________________________________
> > seam-dev mailing list
> > seam-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/seam-dev
>
> _______________________________________________
> seam-dev mailing list
> seam-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/seam-dev
>



-- 
Jason Porter
http://lightguard-jp.blogspot.com
http://twitter.com/lightguardjp

Software Engineer
Open Source Advocate
Author of Seam Catch - Next Generation Java Exception Handling

PGP key id: 926CCFF5
PGP key available at: keyserver.net, pgp.mit.edu
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/seam-dev/attachments/20110901/f40a7cbd/attachment-0001.html 


More information about the seam-dev mailing list