Pete, Joel Tosi created a PDF, a quick look at the table of contents, I would have a chapter on. I have a war, need a database, what do I do... A Chapter on the embedded console, how to turn it on use it... Some thoughts on bin files that exist...I know you are targeting standalone, but there is that other .sh file there staring at people.... Just some thoughts... Jim Tyrrell Senior JBoss Solutions Architect Did you see RHT on CNBC's Mad Money? http://www.cnbc.com/id/39401056 On Jun 13, 2011, at 9:46 AM, Pete Muir wrote: > In preparation for the AS7 release, I've written an getting started guide for developers for AS 7. The focus of this guide is on the standalone mode of JBoss AS 7, and the EE 6 programming model, and consequently how you can write some simple apps using AS 7. It also includes instructions for using the AS7/EE 6 archetype that we will release alongside the guide. > > I've added the guide + quickstart samples that live alongside it to the docs repo on github - https://github.com/jbossas/docs. This repo also includes a a distro script for building a zip, and some basic development instructions for quickstarts in the README. I just want to emphasise though, that the quickstarts are aimed at users, and so aim to be as simple as possible - we've elminated as many xml files as possible, made the pom as simple as possible etc. This (especially in the pom) means that things are quite as optimised as they might be (e.g. no shared parent in the quickstart poms). This is 100% intentional - the aim here is to have something people can copy and change easily - a shared parent isn't good for this!. > > Anyway, please review, and add any other guides as you wish :-) > > Pete > _______________________________________________ > jboss-as7-dev mailing list > jboss-as7-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

Is there a basic introduction to the AS 7 directory layout somewhere ? That is not dev or admin specific but just as basic Noob explanation. If not I can see if I can give it a shot for the parts I know - and ask others to fill in the blanks? /max On Jun 14, 2011, at 24:23, Pete Muir wrote: > Hi Jim, thanks for the feedback. > > I will add something about how to connect to a database, I am behind on that one ;-) > > Shelly is writing the Getting Started Guide for Admins, which we are aiming to have done for launch: > > * server layout > * intro to embedded console (how to connect etc.) > * details on resource adaptors. > > So hopefully that will meet what you are after :-) > > Last I spoke to Jason, we plan to feature links both guides prominently on localhost:8080, and each should have a short sentence or two describing content so a user goes to the right place. > > On 13 Jun 2011, at 19:50, Jim Tyrrell wrote: > >> Pete, >> >> Joel Tosi created a PDF, a quick look at the table of contents, I would have a chapter on. >> >> I have a war, need a database, what do I do... >> >> A Chapter on the embedded console, how to turn it on use it... >> >> Some thoughts on bin files that exist...I know you are targeting standalone, but there is that other .sh file there staring at people.... >> >> Just some thoughts... >> >> Jim Tyrrell >> Senior JBoss Solutions Architect >> >> Did you see RHT on CNBC's Mad Money? >> http://www.cnbc.com/id/39401056 >> >> >> >> On Jun 13, 2011, at 9:46 AM, Pete Muir wrote: >> >>> In preparation for the AS7 release, I've written an getting started guide for developers for AS 7. The focus of this guide is on the standalone mode of JBoss AS 7, and the EE 6 programming model, and consequently how you can write some simple apps using AS 7. It also includes instructions for using the AS7/EE 6 archetype that we will release alongside the guide. >>> >>> I've added the guide + quickstart samples that live alongside it to the docs repo on github - https://github.com/jbossas/docs. This repo also includes a a distro script for building a zip, and some basic development instructions for quickstarts in the README. I just want to emphasise though, that the quickstarts are aimed at users, and so aim to be as simple as possible - we've elminated as many xml files as possible, made the pom as simple as possible etc. This (especially in the pom) means that things are quite as optimised as they might be (e.g. no shared parent in the quickstart poms). This is 100% intentional - the aim here is to have something people can copy and change easily - a shared parent isn't good for this!. >>> >>> Anyway, please review, and add any other guides as you wish :-) >>> >>> Pete >>> _______________________________________________ >>> jboss-as7-dev mailing list >>> jboss-as7-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev >> > > > _______________________________________________ > jboss-as7-dev mailing list > jboss-as7-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/jboss-as7-dev /max http://about.me/maxandersen

As we are creating these docs, I would prefer to have smaller well named docs, then a kitchen sink doc. A noob guide should be just that...and not a chapter in a greater guide, if we can help it at all. Just my $ .01. Jim Tyrrell Senior JBoss Solutions Architect Did you see RHT on CNBC's Mad Money? http://www.cnbc.com/id/39401056 On Jun 14, 2011, at 5:06 AM, Peter Muir wrote: > Shelly plans a chapter on this for the admin guide. > > -- > Pete Muir > http://in.relation.to/Bloggers/Pete > > On 14 Jun 2011, at 12:05, Max Rydahl Andersen > <max.andersen(a)redhat.com&gt; wrote: > >> Is there a basic introduction to the AS 7 directory layout somewhere ? >> >> That is not dev or admin specific but just as basic Noob explanation. >> >> If not I can see if I can give it a shot for the parts I know - and >> ask others to fill in the blanks? >> >> /max >> >> On Jun 14, 2011, at 24:23, Pete Muir wrote: >> >>> Hi Jim, thanks for the feedback. >>> >>> I will add something about how to connect to a database, I am >>> behind on that one ;-) >>> >>> Shelly is writing the Getting Started Guide for Admins, which we >>> are aiming to have done for launch: >>> >>> * server layout >>> * intro to embedded console (how to connect etc.) >>> * details on resource adaptors. >>> >>> So hopefully that will meet what you are after :-) >>> >>> Last I spoke to Jason, we plan to feature links both guides >>> prominently on localhost:8080, and each should have a short >>> sentence or two describing content so a user goes to the right place. >>> >>> On 13 Jun 2011, at 19:50, Jim Tyrrell wrote: >>> >>>> Pete, >>>> >>>> Joel Tosi created a PDF, a quick look at the table of contents, I >>>> would have a chapter on. >>>> >>>> I have a war, need a database, what do I do... >>>> >>>> A Chapter on the embedded console, how to turn it on use it... >>>> >>>> Some thoughts on bin files that exist...I know you are targeting >>>> standalone, but there is that other .sh file there staring at >>>> people.... >>>> >>>> Just some thoughts... >>>> >>>> Jim Tyrrell >>>> Senior JBoss Solutions Architect >>>> >>>> Did you see RHT on CNBC's Mad Money? >>>> http://www.cnbc.com/id/39401056 >>>> >>>> >>>> >>>> On Jun 13, 2011, at 9:46 AM, Pete Muir wrote: >>>> >>>>> In preparation for the AS7 release, I've written an getting >>>>> started guide for developers for AS 7. The focus of this guide is >>>>> on the standalone mode of JBoss AS 7, and the EE 6 programming >>>>> model, and consequently how you can write some simple apps using >>>>> AS 7. It also includes instructions for using the AS7/EE 6 >>>>> archetype that we will release alongside the guide. >>>>> >>>>> I've added the guide + quickstart samples that live alongside it >>>>> to the docs repo on github - https://github.com/jbossas/docs. >>>>> This repo also includes a a distro script for building a zip, and >>>>> some basic development instructions for quickstarts in the >>>>> README. I just want to emphasise though, that the quickstarts are >>>>> aimed at users, and so aim to be as simple as possible - we've >>>>> elminated as many xml files as possible, made the pom as simple >>>>> as possible etc. This (especially in the pom) means that things >>>>> are quite as optimised as they might be (e.g. no shared parent in >>>>> the quickstart poms). This is 100% intentional - the aim here is >>>>> to have something people can copy and change easily - a shared >>>>> parent isn't good for this!. >>>>> >>>>> Anyway, please review, and add any other guides as you wish :-) >>>>> >>>>> Pete >>>>> _______________________________________________ >>>>> jboss-as7-dev mailing list >>>>> jboss-as7-dev(a)lists.jboss.org >>>>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev >>>> >>> >>> >>> _______________________________________________ >>> jboss-as7-dev mailing list >>> jboss-as7-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev >> >> /max >> http://about.me/maxandersen >> >> >> _______________________________________________ jboss-as7-dev mailing list jboss-as7-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

Issue is what goes in a newbie guide varies depending on who you talk to. For me and burr, it would be how to write apps. For you it's layout of server + connecting a datasource. Personally, I think this split works well. A basic guide about how to write apps. A basic guide on how to use the server. Then reference guides for the detail. So basically, I think the way you would split it is wrong :-p -- Pete Muir http://in.relation.to/Bloggers/Pete On 14 Jun 2011, at 15:00, Jim Tyrrell <jtyrrell(a)redhat.com&gt; wrote: > As we are creating these docs, I would prefer to have smaller well named docs, then a kitchen sink doc. A noob guide should be just that...and not a chapter in a greater guide, if we can help it at all. Just my $ .01. > > Jim Tyrrell > Senior JBoss Solutions Architect > > Did you see RHT on CNBC's Mad Money? > http://www.cnbc.com/id/39401056 > > > > On Jun 14, 2011, at 5:06 AM, Peter Muir wrote: > >> Shelly plans a chapter on this for the admin guide. >> >> -- >> Pete Muir >> http://in.relation.to/Bloggers/Pete >> >> On 14 Jun 2011, at 12:05, Max Rydahl Andersen <max.andersen(a)redhat.com&gt; wrote: >> >>> Is there a basic introduction to the AS 7 directory layout somewhere ? >>> >>> That is not dev or admin specific but just as basic Noob explanation. >>> >>> If not I can see if I can give it a shot for the parts I know - and ask others to fill in the blanks? >>> >>> /max >>> >>> On Jun 14, 2011, at 24:23, Pete Muir wrote: >>> >>>> Hi Jim, thanks for the feedback. >>>> >>>> I will add something about how to connect to a database, I am behind on that one ;-) >>>> >>>> Shelly is writing the Getting Started Guide for Admins, which we are aiming to have done for launch: >>>> >>>> * server layout >>>> * intro to embedded console (how to connect etc.) >>>> * details on resource adaptors. >>>> >>>> So hopefully that will meet what you are after :-) >>>> >>>> Last I spoke to Jason, we plan to feature links both guides prominently on localhost:8080, and each should have a short sentence or two describing content so a user goes to the right place. >>>> >>>> On 13 Jun 2011, at 19:50, Jim Tyrrell wrote: >>>> >>>>> Pete, >>>>> >>>>> Joel Tosi created a PDF, a quick look at the table of contents, I would have a chapter on. >>>>> >>>>> I have a war, need a database, what do I do... >>>>> >>>>> A Chapter on the embedded console, how to turn it on use it... >>>>> >>>>> Some thoughts on bin files that exist...I know you are targeting standalone, but there is that other .sh file there staring at people.... >>>>> >>>>> Just some thoughts... >>>>> >>>>> Jim Tyrrell >>>>> Senior JBoss Solutions Architect >>>>> >>>>> Did you see RHT on CNBC's Mad Money? >>>>> http://www.cnbc.com/id/39401056 >>>>> >>>>> >>>>> >>>>> On Jun 13, 2011, at 9:46 AM, Pete Muir wrote: >>>>> >>>>>> In preparation for the AS7 release, I've written an getting started guide for developers for AS 7. The focus of this guide is on the standalone mode of JBoss AS 7, and the EE 6 programming model, and consequently how you can write some simple apps using AS 7. It also includes instructions for using the AS7/EE 6 archetype that we will release alongside the guide. >>>>>> >>>>>> I've added the guide + quickstart samples that live alongside it to the docs repo on github - https://github.com/jbossas/docs. This repo also includes a a distro script for building a zip, and some basic development instructions for quickstarts in the README. I just want to emphasise though, that the quickstarts are aimed at users, and so aim to be as simple as possible - we've elminated as many xml files as possible, made the pom as simple as possible etc. This (especially in the pom) means that things are quite as optimised as they might be (e.g. no shared parent in the quickstart poms). This is 100% intentional - the aim here is to have something people can copy and change easily - a shared parent isn't good for this!. >>>>>> >>>>>> Anyway, please review, and add any other guides as you wish :-) >>>>>> >>>>>> Pete >>>>>> _______________________________________________ >>>>>> jboss-as7-dev mailing list >>>>>> jboss-as7-dev(a)lists.jboss.org >>>>>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev >>>>> >>>> >>>> >>>> _______________________________________________ >>>> jboss-as7-dev mailing list >>>> jboss-as7-dev(a)lists.jboss.org >>>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev >>> >>> /max >>> http://about.me/maxandersen >>> >>> >>> >

Anyway, please review, and add any other guides as you wish :-)

On Tuesday, June 14, 2011 11:19:37 AM Jesper Pedersen wrote: > Once it is pulled upstream we can discuss the chapter layout. Before everybody starts to think about it - here is my suggestion as attached. Comments are of course welcome ... and yes, the content will only be added if people add the sections they are responsible for ... Trust me, you don't want me to write about your stuff ;) So start typing, copy'n'pasting, or how ever you write docs ... Best regards, Jesper _______________________________________________ jboss-as7-dev mailing list jboss-as7-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

I wonder, if some content can be added on JBoss Modules which leads to some content on new class loading architecture and msc (modular service container).

On Tuesday, June 14, 2011 11:19:37 AM Jesper Pedersen wrote: > Once it is pulled upstream we can discuss the chapter layout. Before everybody starts to think about it - here is my suggestion as attached. Comments are of course welcome ... and yes, the content will only be added if people add the sections they are responsible for ... Trust me, you don't want me to write about your stuff ;) So start typing, copy'n'pasting, or how ever you write docs ... Best regards, Jesper <admin.txt>_______________________________________________ jboss-as7-dev mailing list jboss-as7-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

> Before everybody starts to think about it - here is my suggestion as > attached. IMO a lot of this content is a general admin guide.

The getting started guide should be very simple and just cover a few config topics. My list would be: * App server layout * Logging configuration * Adding a datasource * Getting started with the management console * Getting started with the CLI Anything else should be bumped to a general admin guide - don't want to overwhelm people!

I would suggest a similar approach for developer guides. What we have now for the getting started guide shouldn't be expanded on too much. When we add docs for using every feature in EJB or CDI, this should go in the main Developers Guide.

>> I would suggest a similar approach for developer guides. What we have now >> for the getting started guide shouldn't be expanded on too much. When we >> add docs for using every feature in EJB or CDI, this should go in the main >> Developers Guide. > > Agreed. However I see most of the information being in the project specific > docs - and the Developer Guide more of a place where it is described how the > techs related, and a basic getting started from a programming PoV. Agreed.

Can we have something similar to what Glassfish ships with. I have used Glassfish docs and I must admit they are just fabulous. On 15/06/2011 10:39 PM, Pete Muir wrote: > On 15 Jun 2011, at 14:33, Pete Muir wrote: > >>>> I would suggest a similar approach for developer guides. What we have now >>>> for the getting started guide shouldn't be expanded on too much. When we >>>> add docs for using every feature in EJB or CDI, this should go in the main >>>> Developers Guide. >>> Agreed. However I see most of the information being in the project specific >>> docs - and the Developer Guide more of a place where it is described how the >>> techs related, and a basic getting started from a programming PoV. >> Agreed. > Though I do want to add, I think for the developer guide that (although maybe not right away) that we do offer an integrated guide to writing apps for Java EE, not writing apps for each of the Java EE components (EJB, CDI, Servlets) - this needs to be seen as a coherent platform. > > Bruno, is this on your plan? > _______________________________________________ > jboss-as7-dev mailing list > jboss-as7-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/jboss-as7-dev _______________________________________________ jboss-as7-dev mailing list jboss-as7-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

Here you go :-) http://download.oracle.com/javaee/6/tutorial/doc/ This is a big fat book ~1000 pages and I believe we can still improve upon this by adding more stuff around e.g CDI : like adding Seam 3, writing CDI extensions etc. Also, for other Glassfish guides look at : http://download.java.net/glassfish/3.1/release/glassfish-ose-3.1-docs-pdf... Thx Vimal On 15/06/2011 10:45 PM, Pete Muir wrote: > Vimal, do you have a link (as I am lazy). > > On 15 Jun 2011, at 14:42, Vimal Kansal wrote: > >> Can we have something similar to what Glassfish ships with. I have used >> Glassfish docs and I must admit they are just fabulous. >> >> On 15/06/2011 10:39 PM, Pete Muir wrote: >>> On 15 Jun 2011, at 14:33, Pete Muir wrote: >>> >>>>>> I would suggest a similar approach for developer guides. What we have now >>>>>> for the getting started guide shouldn't be expanded on too much. When we >>>>>> add docs for using every feature in EJB or CDI, this should go in the main >>>>>> Developers Guide. >>>>> Agreed. However I see most of the information being in the project specific >>>>> docs - and the Developer Guide more of a place where it is described how the >>>>> techs related, and a basic getting started from a programming PoV. >>>> Agreed. >>> Though I do want to add, I think for the developer guide that (although maybe not right away) that we do offer an integrated guide to writing apps for Java EE, not writing apps for each of the Java EE components (EJB, CDI, Servlets) - this needs to be seen as a coherent platform. >>> >>> Bruno, is this on your plan? >>> _______________________________________________ >>> jboss-as7-dev mailing list >>> jboss-as7-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev >> _______________________________________________ >> jboss-as7-dev mailing list >> jboss-as7-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

In preparation for the AS7 release, I've written an getting started guide for developers for AS 7. The focus of this guide is on the standalone mode of JBoss AS 7, and the EE 6 programming model, and consequently how you can write some simple apps using AS 7. It also includes instructions for using the AS7/EE 6 archetype that we will release alongside the guide. I've added the guide + quickstart samples that live alongside it to the docs repo on github - https://github.com/jbossas/docs. This repo also includes a a distro script for building a zip, and some basic development instructions for quickstarts in the README. I just want to emphasise though, that the quickstarts are aimed at users, and so aim to be as simple as possible - we've elminated as many xml files as possible, made the pom as simple as possible etc. This (especially in the pom) means that things are quite as optimised as they might be (e.g. no shared parent in the quickstart poms). This is 100% intentional - the aim here is to have something people can copy and change easily - a shared parent isn't good for this!. Anyway, please review, and add any other guides as you wish :-) Pete _______________________________________________ jboss-as7-dev mailing list jboss-as7-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jboss-as7-dev

If you mean how do we "forward link" from one guide to another, then not sure. On 14 Jun 2011, at 21:36, Scott Marlow wrote: > How does this all impact those using confluence? Should we commit docbook changes to link to the https://docs.jboss.org/author/display/AS7/Home section (implying that the docbook content will be inserted later)? > > > On 06/13/2011 11:46 AM, Pete Muir wrote: >> In preparation for the AS7 release, I've written an getting started guide for developers for AS 7. The focus of this guide is on the standalone mode of JBoss AS 7, and the EE 6 programming model, and consequently how you can write some simple apps using AS 7. It also includes instructions for using the AS7/EE 6 archetype that we will release alongside the guide. >> >> I've added the guide + quickstart samples that live alongside it to the docs repo on github - https://github.com/jbossas/docs. This repo also includes a a distro script for building a zip, and some basic development instructions for quickstarts in the README. I just want to emphasise though, that the quickstarts are aimed at users, and so aim to be as simple as possible - we've elminated as many xml files as possible, made the pom as simple as possible etc. This (especially in the pom) means that things are quite as optimised as they might be (e.g. no shared parent in the quickstart poms). This is 100% intentional - the aim here is to have something people can copy and change easily - a shared parent isn't good for this!. >> >> Anyway, please review, and add any other guides as you wish :-) >> >> Pete >> _______________________________________________ >> jboss-as7-dev mailing list >> jboss-as7-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev > _______________________________________________ jboss-as7-dev mailing list jboss-as7-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jboss-as7-dev