I don't know. I don't really have plans to include docbook in the dist until we get some better integration there from the .ORG team. I don't see that happening, though, so until then, online docs are the way people will be learning about forge. Our tools don't make this easy.<br>
<br>I don't think the connectivity issue will be a problem. People can always print or download the site for later if they have connectivity issues. It might be nice (on confluence) to be able to have a 1-click download, though.<br>
<br>~Lincoln<br><br><div class="gmail_quote">On Thu, Sep 1, 2011 at 11:51 PM, Shane Bryzak <span dir="ltr"><<a href="mailto:sbryzak@redhat.com">sbryzak@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div text="#000000" bgcolor="#FFFFFF">
Yeah, that's a good idea. Do you have plans to provide
documentation as part of the Forge download? I'm thinking of the
users who might have no/limited connectivity who won't be able to
access the Forge docs online. Also, how does confluence work in
conjunction with our documentation team? From my understanding all
their tools for translating etc are based on Publican/Docbook.<div><div></div><div class="h5"><br>
<br>
On 02/09/11 13:48, Lincoln Baxter, III wrote:
<blockquote type="cite">Actually, maybe the best thing to do is just to add a
new section to the Seam umbrella doc, with an HTML link to the
forge confluence space?<br>
<br>
<div class="gmail_quote">On Thu, Sep 1, 2011 at 7:54 PM, Lincoln
Baxter, III <span dir="ltr"><<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<p>Ok. If you include beta1, the artifact for dist is:</p>
<p>org.jboss.forge:forge-modules:1.0.0.Beta1 </p>
<div>
<p>--<br>
Lincoln Baxter's Droid<br>
<a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
"Keep it Simple"</p>
</div>
<div class="gmail_quote">
<div>On Sep 1, 2011 7:52 PM, "Shane Bryzak" <<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>> wrote:<br type="attribution">
> Yep, I planned on extracting it in the forge folder.<br>
> <br>
> On 02/09/11 09:43, Lincoln Baxter, III wrote:<br>
>><br>
>> Also, if forge is unzipped. It should be done so
in its own subfolder.<br>
>><br>
>> Ill try to catch you online tonight and make sure
you've got the right <br>
>> artifact. (it moved temporarily during the jboss
modules transition.<br>
>><br>
>> --<br>
>> Lincoln Baxter's Droid<br>
>> <a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
>> "Keep it Simple"<br>
>><br>
>> On Sep 1, 2011 7:41 PM, "Lincoln Baxter, III"
<<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>
<br>
</div>
<div>>> <mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>>>
wrote:<br>
</div>
<div>
>> > Well. The forge distribution doesn't contain
docs either. They are <br>
>> purely<br>
>> > online at this point. So I think just don't
worry about it. This <br>
>> confluence<br>
>> > thing is a bit of a pain in that regard.<br>
>> ><br>
>> > --<br>
>> > Lincoln Baxter's Droid<br>
>> > <a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
>> > "Keep it Simple"<br>
>> > On Sep 1, 2011 6:05 PM, "Shane Bryzak" <<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a> <br>
</div>
<div>
>> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>>>
wrote:<br>
>> >> Unless an export could be automated as
part of the build process, I<br>
>> >> don't think that's a good idea. How
about we just include the Forge<br>
>> >> distribution extracted inside the Seam
distribution? The documentation<br>
>> >> won't be combined with the main Seam
docs, but as long as it's in the<br>
>> >> Forge distribution then a user should be
able to find it without too<br>
>> >> much effort.<br>
>> >><br>
>> >> On 02/09/11 01:22, Lincoln Baxter, III
wrote:<br>
>> >>><br>
>> >>> I'm not really sure how to do this,
then. There are no sources since<br>
>> >>> the docs are in confluence.<br>
>> >>><br>
>> >>> I suppose an export could work?<br>
>> >>><br>
>> >>> --<br>
>> >>> Lincoln Baxter's Droid<br>
>> >>> <a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
>> >>> "Keep it Simple"<br>
>> >>><br>
>> >>> On Aug 31, 2011 5:09 PM, "Shane
Bryzak" <<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>
<br>
>> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>><br>
</div>
<div>>> >>> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>>>>
wrote:<br>
</div>
<div>
<div>
>> >>> > The source artifact for the
Forge docs were being pulled in like <br>
>> this:<br>
>> >>> ><br>
>> >>> > <dependency><br>
>> >>> >
<groupId>org.jboss.seam.forge</groupId><br>
>> >>> >
<artifactId>forge-reference-guide</artifactId><br>
>> >>> >
<version>1.0.0-SNAPSHOT</version><br>
>> >>> >
<classifier>sources</classifier><br>
>> >>> > <type>jar</type><br>
>> >>> > </dependency><br>
>> >>> ><br>
>> >>> > When I update the version to
1.0.0.Beta1, it can't find the source -<br>
>> >>> was<br>
>> >>> > the Beta1 source artifact
published to Maven?<br>
>> >>> ><br>
>> >>> ><br>
>> >>> ><br>
>> >>> > On 01/09/11 03:02, Lincoln
Baxter, III wrote:<br>
>> >>> >> <a href="https://docs.jboss.org/author/display/SEAMFORGE/Home" target="_blank">https://docs.jboss.org/author/display/SEAMFORGE/Home</a><br>
>> >>> >><br>
>> >>> >> On Wed, Aug 31, 2011 at
1:02 PM, Lincoln Baxter, III<br>
>> >>> >> <<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>
<mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>>
<br>
>> <mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>
<mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>>><br>
>> >>> <mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>
<mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>>
<br>
>> <mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>
<mailto:<a href="mailto:lincolnbaxter@gmail.com" target="_blank">lincolnbaxter@gmail.com</a>>>>>
wrote:<br>
>> >>> >><br>
>> >>> >> Just checking - the Forge
docs are no longer in SVN / are in<br>
>> >>> >> Confluence; have you
taken this into account?<br>
>> >>> >><br>
>> >>> >> Also, the which
distribution are you including? You could choose<br>
>> >>> >> either Beta1 or the
latest SNAPSHOT (which is actually in a new<br>
>> >>> >> location - moved back to
the original<br>
>> >>> >>
org.jboss.forge:forge-distribution - though it looks
like the<br>
>> >>> >> build hasn't deployed
artifacts in a little while - looking in to<br>
>> >>> >> that)<br>
>> >>> >><br>
>> >>> >> ~Lincoln<br>
>> >>> >><br>
>> >>> >><br>
>> >>> >> On Wed, Aug 31, 2011 at
12:14 AM, Shane Bryzak <br>
>> <<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>
<mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>><br>
>> >>> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>
<mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>>><br>
>> >>> >> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>
<mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>>
<br>
>> <mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>
<mailto:<a href="mailto:sbryzak@redhat.com" target="_blank">sbryzak@redhat.com</a>>>>>
wrote:<br>
>> >>> >><br>
>> >>> >> Module leads,<br>
>> >>> >><br>
>> >>> >> Can you please review the
list below and confirm that the<br>
>> >>> >> documentation<br>
>> >>> >> chapters are correct for
your module. Also, I would like<br>
>> >>> >> everyone to<br>
>> >>> >> take a moment to review
the module documentation guidelines,<br>
>> >>> >> as there<br>
>> >>> >> were a number of
breakages in the bundled documentation build<br>
>> >>> >> because<br>
>> >>> >> the guidelines weren't
adhered to, particularly in the new<br>
>> >>> >> modules for<br>
>> >>> >> Seam 3.1:<br>
>> >>> >><br>
>> >>> >> 1) Always prefix the
filenames of your documentation chapters<br>
>> >>> >> with the<br>
>> >>> >> name of your module. E.g.
security-authentication.xml,<br>
>> >>> >>
security-authorization.xml, etc.<br>
>> >>> >><br>
>> >>> >> 2) Whenever you assign an
ID to a docbook element, such as a<br>
>> >>> >> <chapter><br>
>> >>> >> or <section>,
ALWAYS prefix the id with your module name. For<br>
>> >>> >> example,<br>
>> >>> >> <chapter
id="security-introduction"> or <section<br>
>> >>> >>
id="security-getting-started">. As all of the
chapters for<br>
>> >>> >> all modules<br>
>> >>> >> are combined when
building the bundled documentation, all IDs<br>
>> >>> >> must be<br>
>> >>> >> unique. This is a
particularly time consuming problem to fix<br>
>> >>> >> because<br>
>> >>> >> the error output from the
Maven docbook plugin doesn't tell<br>
>> >>> >> you which<br>
>> >>> >> files are the problem
ones.<br>
>> >>> >><br>
>> >>> >> 3) When adding, renaming
or deleting a chapter of your<br>
>> >>> >> documentation,<br>
>> >>> >> please notify me of the
changes so that I can update<br>
>> >>> >> bundled_master.xml. This
file must be manually kept up to<br>
>> >>> >> date whenever<br>
>> >>> >> any documentation changes
are made.<br>
>> >>> >><br>
>> >>> >> Thanks,<br>
>> >>> >> Shane<br>
>> >>> >><br>
>> >>> >><br>
>> >>> >> <?xml version='1.0'
encoding="utf-8"?><br>
>> >>> >> <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"<br>
>> >>> >> "<a href="http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" target="_blank">http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd</a>"
[ ]><br>
>> >>> >> <book lang="en"
xmlns:xi="<a href="http://www.w3.org/2001/XInclude" target="_blank">http://www.w3.org/2001/XInclude</a>"><br>
>> >>> >><br>
>> >>> >> <toc /><br>
>> >>> >><br>
>> >>> >> <title>Seam
3</title><br>
>> >>> >> <subtitle>Bundled
Reference Guide</subtitle><br>
>> >>> >><br>
>> >>> >> <xi:include
href="bundled_credits.xml"/><br>
>> >>> >> <xi:include
href="bundled_intro.xml"/><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >>
<title>Forge</title><br>
>> >>> >> <xi:include
href="forge-preface.xml" /><br>
>> >>> >> <xi:include
href="forge-installation.xml" /><br>
>> >>> >> <xi:include
href="forge-creating-basic-webapp.xml" /><br>
>> >>> >> <xi:include
href="forge-plugin-dev.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Solder</title><br>
>> >>> >> <xi:include
href="solder-preface.xml"/><br>
>> >>> >> <xi:include
href="solder-gettingstarted.xml"/><br>
>> >>> >> <xi:include
href="solder-programmingmodel.xml"/><br>
>> >>> >> <xi:include
href="solder-annotationliterals.xml"/><br>
>> >>> >> <xi:include
href="solder-elextensions.xml"/><br>
>> >>> >> <xi:include
href="solder-resourceloading.xml"/><br>
>> >>> >> <xi:include
href="solder-logging.xml"/><br>
>> >>> >> <xi:include
href="solder-typeutilities.xml"/><br>
>> >>> >> <xi:include
href="solder-beanmanagerprovider.xml"/><br>
>> >>> >> <xi:include
href="solder-beanutilities.xml"/><br>
>> >>> >> <xi:include
href="solder-properties.xml"/><br>
>> >>> >> <xi:include
href="solder-unwraps.xml"/><br>
>> >>> >> <xi:include
href="solder-defaultbeans.xml"/><br>
>> >>> >> <xi:include
href="solder-genericbeans.xml"/><br>
>> >>> >> <xi:include
href="solder-servicehandler.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Configuration</title><br>
>> >>> >> <xi:include
href="config-introduction.xml"/><br>
>> >>> >> <xi:include
href="config-xml-provider.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Persistence</title><br>
>> >>> >> <xi:include
href="persistence-general.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Transaction</title><br>
>> >>> >> <xi:include
href="transaction-general.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Servlet</title><br>
>> >>> >> <xi:include
href="servlet-introduction.xml"/><br>
>> >>> >> <xi:include
href="servlet-installation.xml"/><br>
>> >>> >> <xi:include
href="servlet-events.xml"/><br>
>> >>> >> <xi:include
href="servlet-injectable_refs.xml"/><br>
>> >>> >> <xi:include
href="servlet-exception_handling.xml" /><br>
>> >>> >> <xi:include
href="servlet-beanmanager.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Security</title><br>
>> >>> >> <xi:include
href="security-introduction.xml"/><br>
>> >>> >> <xi:include
href="security-authentication.xml"/><br>
>> >>> >> <xi:include
href="security-identitymanagement.xml"/><br>
>> >>> >> <xi:include
href="security-authentication-external.xml"/><br>
>> >>> >> <xi:include
href="security-authorization.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
International</title><br>
>> >>> >> <xi:include
href="international-preface.xml" /><br>
>> >>> >> <xi:include
href="international-installation.xml" /><br>
>> >>> >> <xi:include
href="international-locales.xml" /><br>
>> >>> >> <xi:include
href="international-timezones.xml" /><br>
>> >>> >> <xi:include
href="international-messages.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Faces</title><br>
>> >>> >> <xi:include
href="faces-preface.xml" /><br>
>> >>> >> <xi:include
href="faces-installation.xml" /><br>
>> >>> >> <xi:include
href="faces-events.xml" /><br>
>> >>> >> <xi:include
href="faces-scopes.xml" /><br>
>> >>> >> <xi:include
href="faces-messages.xml" /><br>
>> >>> >> <xi:include
href="faces-artifacts.xml" /><br>
>> >>> >> <xi:include
href="faces-components.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Catch</title><br>
>> >>> >> <xi:include
href="catch-introduction.xml"/><br>
>> >>> >> <xi:include
href="catch-installation.xml"/><br>
>> >>> >> <xi:include
href="catch-client_usage.xml"/><br>
>> >>> >> <xi:include
href="catch-advanced_usage.xml"/><br>
>> >>> >> <xi:include
href="catch-integration.xml"/><br>
>> >>> >> <xi:include
href="catch-glossary.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Reports</title><br>
>> >>> >> <xi:include
href="reports-preface.xml" /><br>
>> >>> >> <xi:include
href="reports-installation.xml" /><br>
>> >>> >> <xi:include
href="reports-usage.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Remoting</title><br>
>> >>> >> <xi:include
href="remoting-general.xml"/><br>
>> >>> >> <xi:include
href="remoting-model.xml"/><br>
>> >>> >> <xi:include
href="remoting-validation.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
REST</title><br>
>> >>> >> <xi:include
href="rest-preface.xml" /><br>
>> >>> >> <xi:include
href="rest-installation.xml" /><br>
>> >>> >> <xi:include
href="rest-exception-mapping.xml" /><br>
>> >>> >> <xi:include
href="rest-validation.xml" /><br>
>> >>> >> <xi:include
href="rest-templating.xml" /><br>
>> >>> >> <xi:include
href="rest-client.xml" /><br>
>> >>> >> <xi:include
href="rest-dependencies.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
JCR</title><br>
>> >>> >> <xi:include
href="jcr-introduction.xml" /><br>
>> >>> >> <xi:include
href="jcr-modeshape.xml"/><br>
>> >>> >> <xi:include
href="jcr-jackrabbit.xml"/><br>
>> >>> >> <xi:include
href="jcr-event-mapping.xml"/><br>
>> >>> >> <xi:include
href="jcr-ocm.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
JMS</title><br>
>> >>> >> <xi:include
href="jms-intro.xml" /><br>
>> >>> >> <xi:include
href="jms-installation.xml" /><br>
>> >>> >> <xi:include
href="jms-resource-injection.xml" /><br>
>> >>> >> <xi:include
href="jms-messaging.xml" /><br>
>> >>> >> <xi:include
href="jms-routing.xml" /><br>
>> >>> >> <xi:include
href="jms-mapping-interfaces.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Validation</title><br>
>> >>> >> <xi:include
href="validation-introduction.xml"/><br>
>> >>> >> <xi:include
href="validation-installation.xml"/><br>
>> >>> >> <xi:include
href="validation-dependency-injection.xml"/><br>
>> >>> >> <xi:include
href="validation-method-validation.xml"/><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> <part><br>
>> >>> >> <title>Seam
Wicket</title><br>
>> >>> >> <xi:include
href="wicket-preface.xml" /><br>
>> >>> >> <xi:include
href="wicket-installation.xml" /><br>
>> >>> >> <xi:include
href="wicket-features.xml" /><br>
>> >>> >> </part><br>
>> >>> >><br>
>> >>> >> </book><br>
>> >>> >>
_______________________________________________<br>
>> >>> >> seam-dev mailing list<br>
>> >>> >> <a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>
<mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>>
<br>
>> <mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>
<mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>>><br>
>> >>> <mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>
<mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>>
<br>
>> <mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>
<mailto:<a href="mailto:seam-dev@lists.jboss.org" target="_blank">seam-dev@lists.jboss.org</a>>>><br>
>> >>> >> <a href="https://lists.jboss.org/mailman/listinfo/seam-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/seam-dev</a><br>
>> >>> >><br>
>> >>> >><br>
>> >>> >><br>
>> >>> >><br>
>> >>> >> --<br>
>> >>> >> Lincoln Baxter, III<br>
>> >>> >> <a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
>> >>> >> <a href="http://scrumshark.com" target="_blank">http://scrumshark.com</a><br>
>> >>> >> "Keep it Simple"<br>
>> >>> >><br>
>> >>> >><br>
>> >>> >><br>
>> >>> >><br>
>> >>> >> --<br>
>> >>> >> Lincoln Baxter, III<br>
>> >>> >> <a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
>> >>> >> <a href="http://scrumshark.com" target="_blank">http://scrumshark.com</a><br>
>> >>> >> "Keep it Simple"<br>
>> >>> ><br>
>> >><br>
> <br>
</div>
</div>
</div>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
Lincoln Baxter, III<br>
<a href="http://ocpsoft.com" target="_blank">http://ocpsoft.com</a><br>
<a href="http://scrumshark.com" target="_blank">http://scrumshark.com</a><br>
"Keep it Simple"<br>
</blockquote>
<br>
</div></div></div>
</blockquote></div><br><br clear="all"><br>-- <br>Lincoln Baxter, III<br><a href="http://ocpsoft.com">http://ocpsoft.com</a><br><a href="http://scrumshark.com">http://scrumshark.com</a><br>"Keep it Simple"<br>