Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

I moved over some of the sample migration documents as we had discussed, but
I noticed that about half of them were empty pages.  I didn't move those
over.  I imagine they were created at some point with the intent of
populating the pages with juicy information, but it seems to have never
happened.  I was just going to leave them in the 2.0 documentation and not
recreate them as I don't see the point in creating blank pages unless
someone can argue otherwise.

On Tue, Feb 26, 2008 at 4:24 PM, Hernan Cunico <[EMAIL PROTECTED]> wrote:

> Not opposed, but I just had a flashback of what we did for 1.2 ->
> http://cwiki.apache.org/GMOxDOC12/sample-applications.html. Titles are
> self explanatory ;-)
>
> Another thing to keep in mind would be, and strictly about J2G migration,
> what are the new features we didn't cover then that we should cover now
>
> Cheers!
> Hernan
>
> Jason Warner wrote:
> > I was looking at the migration sample applications (From JBoss to
> > Geronimo) and realized it might take me a while to verify them. Is
> > anyone  opposed to me moving all the sample apps over as-is and noting
> > that they're unverified on 2.1 until I, or some other enterprising
> > individual, is able to go through the steps and verify?
> >
> >
> > On Tue, Feb 26, 2008 at 10:45 AM, Jason Warner <[EMAIL PROTECTED]
> > > wrote:
> >
> > Thanks, Hernan.  I don't think it's just your resolution.  It might
> > take me a bit, but I'll get larger, easier to read snapshots up as
> > soon as I can.
> >
> >
> > On Tue, Feb 26, 2008 at 10:25 AM, Hernan Cunico <[EMAIL PROTECTED]
> > > wrote:
> >
> > Hey Jason,
> > Both pages are gone!
> >
> > quick comment on the  Migrating with the J2G Migration Tool
> > though. Maybe it's my screen resolution but I can barely read
> > the 2 screenshots.
> > Any chance you could update those !?
> >
> > for example make them look like these
> >
> http://cwiki.apache.org/GMOxDOC21/developing-a-simple-java-server-faces-application.html
> >
> > how do those look on your screen?
> >
> > Thanks
> >
> > Cheers!
> > Hernan
> >
> > Jason Warner wrote:
> >  > I'm reworking the way the J2G Migration is worked into the
> > documentation
> >  > and that requires removing a couple pages, but I do not seem
> > to have the
> >  > rights to do that.  Can someone do that for me?  I originall
> > moved over
> >  > the J2G Migration Tool section from the 2.0 documentation and
> > recreated
> >  > it in the Migration section for the 2.1 docs.  After some
> > discussion, it
> >  > was decided that it would probably be best to split it up and
> > cover
> >  > using the tool to migrate under the migration section and
> > cover building
> >  > the tool under the tooling section.  I have created the new
> > documents
> >  > necessary for this in the correct sections, but I am unable
> > to remove
> >  > the previous work.  What I'd like to remove is this:
> >  >
> >
> http://cwiki.apache.org/confluence/display/GMOxDOC21/J2G+Migration+Tool
> >  > and it's child page.  Please ask me if I haven't made clear
> > enough what
> >  > was changed and why this page should be removed.
> >  >
> >  > Thanks!
> >  >
> >  > On Sat, Feb 23, 2008 at 10:26 AM, Jason Warner
> > <[EMAIL PROTECTED] 
> >  > >> wrote:
> >  >
> >  > Sweet.  I can't believe I couldn't figure that out.  It's
> so
> >  > simple.  Thanks, Dan!
> >  >
> >  >
> >  > On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker
> > <[EMAIL PROTECTED] 
> >  >  > >> wrote:
> >  >
> >  > Jason Warner wrote:
> >  >  > I am in need of moving a page.  How might I
> > accomplish this?
> >  >  >
> >  >
> >  > 1. View the page.
> >  > 2. Click the edit tab.
> >  > 3. Under the big title, you should see a Location
> > hierarchy.
> >  > Click the
> >  > yellow EDIT button next to this hierarchy.
> >  > 4. You should be able to pick a new space or parent
> > page. This
> >  > moves it.
> >  >
> >  > --
> >  > Thanks, Dan
> >  > email: mailto://[EMAIL PROTECTED]
> > 
> >  >  > ://[EMAIL PROTECTED] 

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

Not opposed, but I just had a flashback of what we did for 1.2 -> 
http://cwiki.apache.org/GMOxDOC12/sample-applications.html. Titles are self 
explanatory ;-)

Another thing to keep in mind would be, and strictly about J2G migration, what 
are the new features we didn't cover then that we should cover now

Cheers!
Hernan

Jason Warner wrote:
I was looking at the migration sample applications (From JBoss to 
Geronimo) and realized it might take me a while to verify them. Is 
anyone  opposed to me moving all the sample apps over as-is and noting 
that they're unverified on 2.1 until I, or some other enterprising 
individual, is able to go through the steps and verify?



On Tue, Feb 26, 2008 at 10:45 AM, Jason Warner <[EMAIL PROTECTED] 
> wrote:


Thanks, Hernan.  I don't think it's just your resolution.  It might
take me a bit, but I'll get larger, easier to read snapshots up as
soon as I can.


On Tue, Feb 26, 2008 at 10:25 AM, Hernan Cunico <[EMAIL PROTECTED]
> wrote:

Hey Jason,
Both pages are gone!

quick comment on the  Migrating with the J2G Migration Tool
though. Maybe it's my screen resolution but I can barely read
the 2 screenshots.
Any chance you could update those !?

for example make them look like these

http://cwiki.apache.org/GMOxDOC21/developing-a-simple-java-server-faces-application.html

how do those look on your screen?

Thanks

Cheers!
Hernan

Jason Warner wrote:
 > I'm reworking the way the J2G Migration is worked into the
documentation
 > and that requires removing a couple pages, but I do not seem
to have the
 > rights to do that.  Can someone do that for me?  I originall
moved over
 > the J2G Migration Tool section from the 2.0 documentation and
recreated
 > it in the Migration section for the 2.1 docs.  After some
discussion, it
 > was decided that it would probably be best to split it up and
cover
 > using the tool to migrate under the migration section and
cover building
 > the tool under the tooling section.  I have created the new
documents
 > necessary for this in the correct sections, but I am unable
to remove
 > the previous work.  What I'd like to remove is this:
 >
http://cwiki.apache.org/confluence/display/GMOxDOC21/J2G+Migration+Tool
 > and it's child page.  Please ask me if I haven't made clear
enough what
 > was changed and why this page should be removed.
 >
 > Thanks!
 >
 > On Sat, Feb 23, 2008 at 10:26 AM, Jason Warner
<[EMAIL PROTECTED] 
 > >> wrote:
 >
 > Sweet.  I can't believe I couldn't figure that out.  It's so
 > simple.  Thanks, Dan!
 >
 >
 > On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker
<[EMAIL PROTECTED] 
 > >> wrote:
 >
 > Jason Warner wrote:
 >  > I am in need of moving a page.  How might I
accomplish this?
 >  >
 >
 > 1. View the page.
 > 2. Click the edit tab.
 > 3. Under the big title, you should see a Location
hierarchy.
 > Click the
 > yellow EDIT button next to this hierarchy.
 > 4. You should be able to pick a new space or parent
page. This
 > moves it.
 >
 > --
 > Thanks, Dan
 > email: mailto://[EMAIL PROTECTED]

 > ://[EMAIL PROTECTED] >
 >
 >
 >
 >
 > --
 > ~Jason Warner
 >
 >
 >
 >
 > --
 > ~Jason Warner




-- 
~Jason Warner 





--
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

I was looking at the migration sample applications (From JBoss to Geronimo)
and realized it might take me a while to verify them. Is anyone  opposed to
me moving all the sample apps over as-is and noting that they're unverified
on 2.1 until I, or some other enterprising individual, is able to go through
the steps and verify?


On Tue, Feb 26, 2008 at 10:45 AM, Jason Warner <[EMAIL PROTECTED]> wrote:

> Thanks, Hernan.  I don't think it's just your resolution.  It might take
> me a bit, but I'll get larger, easier to read snapshots up as soon as I can.
>
>
> On Tue, Feb 26, 2008 at 10:25 AM, Hernan Cunico <[EMAIL PROTECTED]> wrote:
>
> > Hey Jason,
> > Both pages are gone!
> >
> > quick comment on the  Migrating with the J2G Migration Tool though.
> > Maybe it's my screen resolution but I can barely read the 2 screenshots.
> > Any chance you could update those !?
> >
> > for example make them look like these
> > http://cwiki.apache.org/GMOxDOC21/developing-a-simple-java-server-faces-application.html
> >
> > how do those look on your screen?
> >
> > Thanks
> >
> > Cheers!
> > Hernan
> >
> > Jason Warner wrote:
> > > I'm reworking the way the J2G Migration is worked into the
> > documentation
> > > and that requires removing a couple pages, but I do not seem to have
> > the
> > > rights to do that.  Can someone do that for me?  I originall moved
> > over
> > > the J2G Migration Tool section from the 2.0 documentation and
> > recreated
> > > it in the Migration section for the 2.1 docs.  After some discussion,
> > it
> > > was decided that it would probably be best to split it up and cover
> > > using the tool to migrate under the migration section and cover
> > building
> > > the tool under the tooling section.  I have created the new documents
> > > necessary for this in the correct sections, but I am unable to remove
> > > the previous work.  What I'd like to remove is this:
> > >
> > http://cwiki.apache.org/confluence/display/GMOxDOC21/J2G+Migration+Tool
> > > and it's child page.  Please ask me if I haven't made clear enough
> > what
> > > was changed and why this page should be removed.
> > >
> > > Thanks!
> > >
> > > On Sat, Feb 23, 2008 at 10:26 AM, Jason Warner <[EMAIL PROTECTED]
> > > > wrote:
> > >
> > > Sweet.  I can't believe I couldn't figure that out.  It's so
> > > simple.  Thanks, Dan!
> > >
> > >
> > > On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker <
> > [EMAIL PROTECTED]
> > > > wrote:
> > >
> > > Jason Warner wrote:
> > >  > I am in need of moving a page.  How might I accomplish
> > this?
> > >  >
> > >
> > > 1. View the page.
> > > 2. Click the edit tab.
> > > 3. Under the big title, you should see a Location hierarchy.
> > > Click the
> > > yellow EDIT button next to this hierarchy.
> > > 4. You should be able to pick a new space or parent page. This
> > > moves it.
> > >
> > > --
> > > Thanks, Dan
> > > email: mailto://[EMAIL PROTECTED]
> > > 
> > >
> > >
> > >
> > >
> > > --
> > > ~Jason Warner
> > >
> > >
> > >
> > >
> > > --
> > > ~Jason Warner
> >
>
>
>
> --
> ~Jason Warner




-- 
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

Thanks, Hernan.  I don't think it's just your resolution.  It might take me
a bit, but I'll get larger, easier to read snapshots up as soon as I can.

On Tue, Feb 26, 2008 at 10:25 AM, Hernan Cunico <[EMAIL PROTECTED]> wrote:

> Hey Jason,
> Both pages are gone!
>
> quick comment on the  Migrating with the J2G Migration Tool though. Maybe
> it's my screen resolution but I can barely read the 2 screenshots.
> Any chance you could update those !?
>
> for example make them look like these
> http://cwiki.apache.org/GMOxDOC21/developing-a-simple-java-server-faces-application.html
>
> how do those look on your screen?
>
> Thanks
>
> Cheers!
> Hernan
>
> Jason Warner wrote:
> > I'm reworking the way the J2G Migration is worked into the documentation
> > and that requires removing a couple pages, but I do not seem to have the
> > rights to do that.  Can someone do that for me?  I originall moved over
> > the J2G Migration Tool section from the 2.0 documentation and recreated
> > it in the Migration section for the 2.1 docs.  After some discussion, it
> > was decided that it would probably be best to split it up and cover
> > using the tool to migrate under the migration section and cover building
> > the tool under the tooling section.  I have created the new documents
> > necessary for this in the correct sections, but I am unable to remove
> > the previous work.  What I'd like to remove is this:
> > http://cwiki.apache.org/confluence/display/GMOxDOC21/J2G+Migration+Tool
> > and it's child page.  Please ask me if I haven't made clear enough what
> > was changed and why this page should be removed.
> >
> > Thanks!
> >
> > On Sat, Feb 23, 2008 at 10:26 AM, Jason Warner <[EMAIL PROTECTED]
> > > wrote:
> >
> > Sweet.  I can't believe I couldn't figure that out.  It's so
> > simple.  Thanks, Dan!
> >
> >
> > On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker <[EMAIL PROTECTED]
> > > wrote:
> >
> > Jason Warner wrote:
> >  > I am in need of moving a page.  How might I accomplish this?
> >  >
> >
> > 1. View the page.
> > 2. Click the edit tab.
> > 3. Under the big title, you should see a Location hierarchy.
> > Click the
> > yellow EDIT button next to this hierarchy.
> > 4. You should be able to pick a new space or parent page. This
> > moves it.
> >
> > --
> > Thanks, Dan
> > email: mailto://[EMAIL PROTECTED]
> > 
> >
> >
> >
> >
> > --
> > ~Jason Warner
> >
> >
> >
> >
> > --
> > ~Jason Warner
>



-- 
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

Hey Jason,
Both pages are gone!

quick comment on the  Migrating with the J2G Migration Tool though. Maybe it's 
my screen resolution but I can barely read the 2 screenshots.
Any chance you could update those !? 


for example make them look like these 
http://cwiki.apache.org/GMOxDOC21/developing-a-simple-java-server-faces-application.html

how do those look on your screen?

Thanks

Cheers!
Hernan

Jason Warner wrote:
I'm reworking the way the J2G Migration is worked into the documentation 
and that requires removing a couple pages, but I do not seem to have the 
rights to do that.  Can someone do that for me?  I originall moved over 
the J2G Migration Tool section from the 2.0 documentation and recreated 
it in the Migration section for the 2.1 docs.  After some discussion, it 
was decided that it would probably be best to split it up and cover 
using the tool to migrate under the migration section and cover building 
the tool under the tooling section.  I have created the new documents 
necessary for this in the correct sections, but I am unable to remove 
the previous work.  What I'd like to remove is this: 
http://cwiki.apache.org/confluence/display/GMOxDOC21/J2G+Migration+Tool 
and it's child page.  Please ask me if I haven't made clear enough what 
was changed and why this page should be removed.


Thanks!

On Sat, Feb 23, 2008 at 10:26 AM, Jason Warner <[EMAIL PROTECTED] 
> wrote:


Sweet.  I can't believe I couldn't figure that out.  It's so
simple.  Thanks, Dan!


On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker <[EMAIL PROTECTED]
> wrote:

Jason Warner wrote:
 > I am in need of moving a page.  How might I accomplish this?
 >

1. View the page.
2. Click the edit tab.
3. Under the big title, you should see a Location hierarchy.
Click the
yellow EDIT button next to this hierarchy.
4. You should be able to pick a new space or parent page. This
moves it.

--
Thanks, Dan
email: mailto://[EMAIL PROTECTED]





-- 
~Jason Warner 





--
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

I'm reworking the way the J2G Migration is worked into the documentation and
that requires removing a couple pages, but I do not seem to have the rights
to do that.  Can someone do that for me?  I originall moved over the J2G
Migration Tool section from the 2.0 documentation and recreated it in the
Migration section for the 2.1 docs.  After some discussion, it was decided
that it would probably be best to split it up and cover using the tool to
migrate under the migration section and cover building the tool under the
tooling section.  I have created the new documents necessary for this in the
correct sections, but I am unable to remove the previous work.  What I'd
like to remove is this:
http://cwiki.apache.org/confluence/display/GMOxDOC21/J2G+Migration+Tool and
it's child page.  Please ask me if I haven't made clear enough what was
changed and why this page should be removed.

Thanks!

On Sat, Feb 23, 2008 at 10:26 AM, Jason Warner <[EMAIL PROTECTED]> wrote:

> Sweet.  I can't believe I couldn't figure that out.  It's so simple.
> Thanks, Dan!
>
>
> On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker <[EMAIL PROTECTED]>
> wrote:
>
> > Jason Warner wrote:
> > > I am in need of moving a page.  How might I accomplish this?
> > >
> >
> > 1. View the page.
> > 2. Click the edit tab.
> > 3. Under the big title, you should see a Location hierarchy. Click the
> > yellow EDIT button next to this hierarchy.
> > 4. You should be able to pick a new space or parent page. This moves it.
> >
> > --
> > Thanks, Dan
> > email: mailto://[EMAIL PROTECTED]
> >
> >
>
>
> --
> ~Jason Warner




-- 
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

Sweet.  I can't believe I couldn't figure that out.  It's so simple.
Thanks, Dan!

On Sat, Feb 23, 2008 at 9:09 AM, Dan Becker <[EMAIL PROTECTED]> wrote:

> Jason Warner wrote:
> > I am in need of moving a page.  How might I accomplish this?
> >
>
> 1. View the page.
> 2. Click the edit tab.
> 3. Under the big title, you should see a Location hierarchy. Click the
> yellow EDIT button next to this hierarchy.
> 4. You should be able to pick a new space or parent page. This moves it.
>
> --
> Thanks, Dan
> email: mailto://[EMAIL PROTECTED]
>
>


-- 
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Dan Becker]

Jason Warner wrote:

I am in need of moving a page.  How might I accomplish this?



1. View the page.
2. Click the edit tab.
3. Under the big title, you should see a Location hierarchy. Click the 
yellow EDIT button next to this hierarchy.

4. You should be able to pick a new space or parent page. This moves it.

--
Thanks, Dan
email: mailto://[EMAIL PROTECTED]

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Donald Woods]

How about keeping it in tools and then have a sections under Migration for -
  Geronimo 1.1.1 to 2.1
  Geronimo 2.0 to 2.0
  JBoss to Geronimo

and in the JBoss to Geronimo section, briefly mention the J2G tool and 
include a pointer to its docs


Just a thought.

-Donald


Jason Warner wrote:


On Fri, Feb 22, 2008 at 12:05 PM, Donald Woods <[EMAIL PROTECTED] 
> wrote:


I think J2G should stay listed as a "Tool".  Anything that requires a
developer tool like Eclipse in-order to use it, should be called a tool.


I half agree with what you're saying.  Part of me does want J2G to be in 
the tools section, because it does belong there.  I also think it 
belongs in our migration section, though, and I don't think it's a good 
idea to put it in both.  In my mind, people that are looking for a way 
to migrate to geronimo are much more likely to look in a section labeled 
migration rather than the tool section.  I'm afraid users will miss it 
if it's left in the tools section.  I suppose I could put it back in the 
tools section and then we could add a link to it from the migration 
section. I kind of wish I had thought of that earlier as it's a pretty 
simple solution.  I'm going to wait for a response until doing that, 
though.
 



I always view a "Migration" section in a product's docs as how to
migrate from prior releases, whereas migrating from other vendors
products is complicated enough to deserve its own set of docs, samples
and tutorials.

I'm not sure what you're saying here.  I think the migration section is 
fairly explicit in that it is for migrating an app to Apache Geronimo.  
Were you looking to separate it into a whole new document that isn't 
included in the documentation? 
 




-Donald


Jason Warner wrote:
 > I was looking at transferring the J2G documentation over from 2.0
to 2.1
 > and I noticed that j2g is listed under tools rather than a migration
 > heading.  Are we not going to have a Migration heading?  I'd
prefer to
 > put the tool under something more descriptive so that it really jumps
 > out to a user.  Also, there were some migration sample documents that
 > are now left homeless.  I guess I'm wondering if we should bring back
 > the migration heading.  Thoughts anyone?
 >
 > On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]

 > >> wrote:
 >
 > Lin Sun wrote:
 >  > Hi Hernan, I looked at the index you put out there and I
think it is
 >  > very good!  I cannot wait for these contents to be filled to
 >  > understand a bit more about these exciting 2.1 new features!!
 >  >
 >  > I think it'll be useful to add a FAQ or troubleshooting
section.   I
 >  > hope this can be the first place for a user to look at
whenever they
 >  > run into some probs/exceptions.The content can grow
based on the
 >  > questions we get on the user list.
 >
 > At some point we had a Troubleshooting section, maybe I forgot to
 > bring the title over 2.1 doc. I just added the entry on the
User's
 > guide side.
 > Ideally the Troubleshooting section should be a subset, an
excerpt
 > of some of the other areas already covered. I personally think of
 > Troubleshooting section more like a convenience section.
 >
 > Agree with you that ultimately we want to address every single
 > question from the user list. Hernan's view of the world!? if
a user
 > have an issue doing a task on Geronimo that means that A) G
is not
 > intuitive enough, B) we don't provide enough documentation on
how to
 > perform such task, C) we do have that info but it is a secret
well
 > kept and only a few know about it ;-) , D) all of the above.
 >
 > With that said, tackling an issue on the Troubleshooting
section is
 > a great start but we shouldn't stop there ;-)
 >
 >  >
 >  > Also, I think the sample application and tutorial sections
are a bit
 >  > confusion.  First I look at the sample application and saw
we only
 >  > have 2 down there but then I realized most of the samples
are in the
 >  > tutorial section.
 >
 > The User's guide on the left is somewhat a carry over of
topics from
 > 2.0. For 2.1 I brought back the idea of the Developer's guide and
 > put the Tutorials section there in contrast with Samples section
 > from the User's guide. If you look at the Tutorials you'll
see there
 > is a different approach, it is more aligned with developing
 > applications with GEP for instance, hence the location on the
 > Developer's guide.
 >
 > Sample a

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

On Fri, Feb 22, 2008 at 10:54 AM, Hernan Cunico <[EMAIL PROTECTED]> wrote:

> J2G ended up under tooling because that's how we have it organized on the
> web site
> Development tools
>+ Geronimo Eclipse Plugin
>+ JBoss to Geronimo Migration Tool (J2G)
>
> Just trying to remain consistent. We can definitively create a Migration
> section, move j2g there as well as updating all the previous migration
> examples we used to have on the previous releases.
>
> Moving the content within the same confluence space is really easy.
>

I am in need of moving a page.  How might I accomplish this?

>
> Cheers!
> Hernan
>
> Jason Warner wrote:
> > I was looking at transferring the J2G documentation over from 2.0 to 2.1
> > and I noticed that j2g is listed under tools rather than a migration
> > heading.  Are we not going to have a Migration heading?  I'd prefer to
> > put the tool under something more descriptive so that it really jumps
> > out to a user.  Also, there were some migration sample documents that
> > are now left homeless.  I guess I'm wondering if we should bring back
> > the migration heading.  Thoughts anyone?
> >
> > On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]
> > > wrote:
> >
> > Lin Sun wrote:
> >  > Hi Hernan, I looked at the index you put out there and I think it
> is
> >  > very good!  I cannot wait for these contents to be filled to
> >  > understand a bit more about these exciting 2.1 new features!!
> >  >
> >  > I think it'll be useful to add a FAQ or troubleshooting section.
>   I
> >  > hope this can be the first place for a user to look at whenever
> they
> >  > run into some probs/exceptions.The content can grow based on
> the
> >  > questions we get on the user list.
> >
> > At some point we had a Troubleshooting section, maybe I forgot to
> > bring the title over 2.1 doc. I just added the entry on the User's
> > guide side.
> > Ideally the Troubleshooting section should be a subset, an excerpt
> > of some of the other areas already covered. I personally think of
> > Troubleshooting section more like a convenience section.
> >
> > Agree with you that ultimately we want to address every single
> > question from the user list. Hernan's view of the world!? if a user
> > have an issue doing a task on Geronimo that means that A) G is not
> > intuitive enough, B) we don't provide enough documentation on how to
> > perform such task, C) we do have that info but it is a secret well
> > kept and only a few know about it ;-) , D) all of the above.
> >
> > With that said, tackling an issue on the Troubleshooting section is
> > a great start but we shouldn't stop there ;-)
> >
> >  >
> >  > Also, I think the sample application and tutorial sections are a
> bit
> >  > confusion.  First I look at the sample application and saw we
> only
> >  > have 2 down there but then I realized most of the samples are in
> the
> >  > tutorial section.
> >
> > The User's guide on the left is somewhat a carry over of topics from
> > 2.0. For 2.1 I brought back the idea of the Developer's guide and
> > put the Tutorials section there in contrast with Samples section
> > from the User's guide. If you look at the Tutorials you'll see there
> > is a different approach, it is more aligned with developing
> > applications with GEP for instance, hence the location on the
> > Developer's guide.
> >
> > Sample applications could end up being renamed to just Samples as it
> > included some sample configurations as well.
> >
> > Either way, The doc is still on its early stages and this may change
> > as we continue to develop the content.
> >
> > As usual, comments, new ideas and most definitively doc
> > contributions are always welcome
> >
> >
> > Cheers!
> > Hernan
> >
> >  >
> >  > Lin
> >  >
> >  > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico
> > <[EMAIL PROTECTED] > wrote:
> >  >> Hey Kevan, Thanks for updating the doc.
> >  >>
> >  >>  I thought it would be useful for the users to know what
> > versions are we using for the components/projects that make Geronimo
> > v2.1
> >  >>  For example, what version of Tomcat, Jetty, Derby, Axis...
> >  >>
> >  >>  It would even help us to keep track of the components and
> > versions, all in one place.
> >  >>
> >  >>  Maybe this info could later on live on the Geronimo
> > architecture section. Once we have the info it's easier to move.
> >  >>
> >  >>  Cheers!
> >  >>  Hernan
> >  >>
> >  >>
> >  >>
> >  >>  Kevan Miller wrote:
> >  >>  >
> >  >>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
> >  >>  >
> >  >>  >> Hi All,
> >  >>  >> these are some of the topics I think we should c

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

Jason Warner wrote:


On Fri, Feb 22, 2008 at 12:05 PM, Donald Woods <[EMAIL PROTECTED] 
> wrote:


I think J2G should stay listed as a "Tool".  Anything that requires a
developer tool like Eclipse in-order to use it, should be called a tool.


I half agree with what you're saying.  Part of me does want J2G to be in 
the tools section, because it does belong there.  I also think it 
belongs in our migration section, though, and I don't think it's a good 
idea to put it in both.  In my mind, people that are looking for a way 
to migrate to geronimo are much more likely to look in a section labeled 
migration rather than the tool section.  I'm afraid users will miss it 
if it's left in the tools section.  I suppose I could put it back in the 
tools section and then we could add a link to it from the migration 
section. I kind of wish I had thought of that earlier as it's a pretty 
simple solution.  I'm going to wait for a response until doing that, 
though.
 



Yes, it is a very simple solution. I think the description of the J2G belongs 
to the tooling section and how to use it, working examples and migration 
samples belong to a Migration section.
In the Tooling we may want to focus on describing what are the tools available, what do 
they do, why, etc. but not necessarily cover in detail the "how to"

In the Migration section, when covering migration from different 
platforms/vendors, you reference to the tooling section for details on this 
tool and then quickly turn into how to use the J2G migration tool providing 
examples, tutorials, sample apps, whatever is needed to get the message through.

Cheers!
Hernan



I always view a "Migration" section in a product's docs as how to
migrate from prior releases, whereas migrating from other vendors
products is complicated enough to deserve its own set of docs, samples
and tutorials.

I'm not sure what you're saying here.  I think the migration section is 
fairly explicit in that it is for migrating an app to Apache Geronimo.  
Were you looking to separate it into a whole new document that isn't 
included in the documentation? 
 




-Donald


Jason Warner wrote:
 > I was looking at transferring the J2G documentation over from 2.0
to 2.1
 > and I noticed that j2g is listed under tools rather than a migration
 > heading.  Are we not going to have a Migration heading?  I'd
prefer to
 > put the tool under something more descriptive so that it really jumps
 > out to a user.  Also, there were some migration sample documents that
 > are now left homeless.  I guess I'm wondering if we should bring back
 > the migration heading.  Thoughts anyone?
 >
 > On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]

 > >> wrote:
 >
 > Lin Sun wrote:
 >  > Hi Hernan, I looked at the index you put out there and I
think it is
 >  > very good!  I cannot wait for these contents to be filled to
 >  > understand a bit more about these exciting 2.1 new features!!
 >  >
 >  > I think it'll be useful to add a FAQ or troubleshooting
section.   I
 >  > hope this can be the first place for a user to look at
whenever they
 >  > run into some probs/exceptions.The content can grow
based on the
 >  > questions we get on the user list.
 >
 > At some point we had a Troubleshooting section, maybe I forgot to
 > bring the title over 2.1 doc. I just added the entry on the
User's
 > guide side.
 > Ideally the Troubleshooting section should be a subset, an
excerpt
 > of some of the other areas already covered. I personally think of
 > Troubleshooting section more like a convenience section.
 >
 > Agree with you that ultimately we want to address every single
 > question from the user list. Hernan's view of the world!? if
a user
 > have an issue doing a task on Geronimo that means that A) G
is not
 > intuitive enough, B) we don't provide enough documentation on
how to
 > perform such task, C) we do have that info but it is a secret
well
 > kept and only a few know about it ;-) , D) all of the above.
 >
 > With that said, tackling an issue on the Troubleshooting
section is
 > a great start but we shouldn't stop there ;-)
 >
 >  >
 >  > Also, I think the sample application and tutorial sections
are a bit
 >  > confusion.  First I look at the sample application and saw
we only
 >  > have 2 down there but then I realized most of the samples
are in the
 >  > tutorial section.
 >
 > The User's guide on the left is somewhat a carry over of
topics from
 > 2.0. For 2.1 I brought back the ide

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

On Fri, Feb 22, 2008 at 12:05 PM, Donald Woods <[EMAIL PROTECTED]> wrote:

> I think J2G should stay listed as a "Tool".  Anything that requires a
> developer tool like Eclipse in-order to use it, should be called a tool.
>

I half agree with what you're saying.  Part of me does want J2G to be in the
tools section, because it does belong there.  I also think it belongs in our
migration section, though, and I don't think it's a good idea to put it in
both.  In my mind, people that are looking for a way to migrate to geronimo
are much more likely to look in a section labeled migration rather than the
tool section.  I'm afraid users will miss it if it's left in the tools
section.  I suppose I could put it back in the tools section and then we
could add a link to it from the migration section. I kind of wish I had
thought of that earlier as it's a pretty simple solution.  I'm going to wait
for a response until doing that, though.


>
> I always view a "Migration" section in a product's docs as how to
> migrate from prior releases, whereas migrating from other vendors
> products is complicated enough to deserve its own set of docs, samples
> and tutorials.
>
I'm not sure what you're saying here.  I think the migration section is
fairly explicit in that it is for migrating an app to Apache Geronimo.  Were
you looking to separate it into a whole new document that isn't included in
the documentation?


>
>
> -Donald
>
>
> Jason Warner wrote:
> > I was looking at transferring the J2G documentation over from 2.0 to 2.1
> > and I noticed that j2g is listed under tools rather than a migration
> > heading.  Are we not going to have a Migration heading?  I'd prefer to
> > put the tool under something more descriptive so that it really jumps
> > out to a user.  Also, there were some migration sample documents that
> > are now left homeless.  I guess I'm wondering if we should bring back
> > the migration heading.  Thoughts anyone?
> >
> > On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]
> > > wrote:
> >
> > Lin Sun wrote:
> >  > Hi Hernan, I looked at the index you put out there and I think it
> is
> >  > very good!  I cannot wait for these contents to be filled to
> >  > understand a bit more about these exciting 2.1 new features!!
> >  >
> >  > I think it'll be useful to add a FAQ or troubleshooting section.
>   I
> >  > hope this can be the first place for a user to look at whenever
> they
> >  > run into some probs/exceptions.The content can grow based on
> the
> >  > questions we get on the user list.
> >
> > At some point we had a Troubleshooting section, maybe I forgot to
> > bring the title over 2.1 doc. I just added the entry on the User's
> > guide side.
> > Ideally the Troubleshooting section should be a subset, an excerpt
> > of some of the other areas already covered. I personally think of
> > Troubleshooting section more like a convenience section.
> >
> > Agree with you that ultimately we want to address every single
> > question from the user list. Hernan's view of the world!? if a user
> > have an issue doing a task on Geronimo that means that A) G is not
> > intuitive enough, B) we don't provide enough documentation on how to
> > perform such task, C) we do have that info but it is a secret well
> > kept and only a few know about it ;-) , D) all of the above.
> >
> > With that said, tackling an issue on the Troubleshooting section is
> > a great start but we shouldn't stop there ;-)
> >
> >  >
> >  > Also, I think the sample application and tutorial sections are a
> bit
> >  > confusion.  First I look at the sample application and saw we
> only
> >  > have 2 down there but then I realized most of the samples are in
> the
> >  > tutorial section.
> >
> > The User's guide on the left is somewhat a carry over of topics from
> > 2.0. For 2.1 I brought back the idea of the Developer's guide and
> > put the Tutorials section there in contrast with Samples section
> > from the User's guide. If you look at the Tutorials you'll see there
> > is a different approach, it is more aligned with developing
> > applications with GEP for instance, hence the location on the
> > Developer's guide.
> >
> > Sample applications could end up being renamed to just Samples as it
> > included some sample configurations as well.
> >
> > Either way, The doc is still on its early stages and this may change
> > as we continue to develop the content.
> >
> > As usual, comments, new ideas and most definitively doc
> > contributions are always welcome
> >
> >
> > Cheers!
> > Hernan
> >
> >  >
> >  > Lin
> >  >
> >  > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico
> > <[EMAIL PROTECTED] > wrote:
> >  >> Hey Kevan, Thanks for updating the doc.
> >  >>
> >  >>  I th

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Donald Woods]

I think J2G should stay listed as a "Tool".  Anything that requires a 
developer tool like Eclipse in-order to use it, should be called a tool.


I always view a "Migration" section in a product's docs as how to 
migrate from prior releases, whereas migrating from other vendors 
products is complicated enough to deserve its own set of docs, samples 
and tutorials.



-Donald


Jason Warner wrote:
I was looking at transferring the J2G documentation over from 2.0 to 2.1 
and I noticed that j2g is listed under tools rather than a migration 
heading.  Are we not going to have a Migration heading?  I'd prefer to 
put the tool under something more descriptive so that it really jumps 
out to a user.  Also, there were some migration sample documents that 
are now left homeless.  I guess I'm wondering if we should bring back 
the migration heading.  Thoughts anyone?


On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED] 
> wrote:


Lin Sun wrote:
 > Hi Hernan, I looked at the index you put out there and I think it is
 > very good!  I cannot wait for these contents to be filled to
 > understand a bit more about these exciting 2.1 new features!!
 >
 > I think it'll be useful to add a FAQ or troubleshooting section.   I
 > hope this can be the first place for a user to look at whenever they
 > run into some probs/exceptions.The content can grow based on the
 > questions we get on the user list.

At some point we had a Troubleshooting section, maybe I forgot to
bring the title over 2.1 doc. I just added the entry on the User's
guide side.
Ideally the Troubleshooting section should be a subset, an excerpt
of some of the other areas already covered. I personally think of
Troubleshooting section more like a convenience section.

Agree with you that ultimately we want to address every single
question from the user list. Hernan's view of the world!? if a user
have an issue doing a task on Geronimo that means that A) G is not
intuitive enough, B) we don't provide enough documentation on how to
perform such task, C) we do have that info but it is a secret well
kept and only a few know about it ;-) , D) all of the above.

With that said, tackling an issue on the Troubleshooting section is
a great start but we shouldn't stop there ;-)

 >
 > Also, I think the sample application and tutorial sections are a bit
 > confusion.  First I look at the sample application and saw we only
 > have 2 down there but then I realized most of the samples are in the
 > tutorial section.

The User's guide on the left is somewhat a carry over of topics from
2.0. For 2.1 I brought back the idea of the Developer's guide and
put the Tutorials section there in contrast with Samples section
from the User's guide. If you look at the Tutorials you'll see there
is a different approach, it is more aligned with developing
applications with GEP for instance, hence the location on the
Developer's guide.

Sample applications could end up being renamed to just Samples as it
included some sample configurations as well.

Either way, The doc is still on its early stages and this may change
as we continue to develop the content.

As usual, comments, new ideas and most definitively doc
contributions are always welcome


Cheers!
Hernan

 >
 > Lin
 >
 > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico
<[EMAIL PROTECTED] > wrote:
 >> Hey Kevan, Thanks for updating the doc.
 >>
 >>  I thought it would be useful for the users to know what
versions are we using for the components/projects that make Geronimo
v2.1
 >>  For example, what version of Tomcat, Jetty, Derby, Axis...
 >>
 >>  It would even help us to keep track of the components and
versions, all in one place.
 >>
 >>  Maybe this info could later on live on the Geronimo
architecture section. Once we have the info it's easier to move.
 >>
 >>  Cheers!
 >>  Hernan
 >>
 >>
 >>
 >>  Kevan Miller wrote:
 >>  >
 >>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
 >>  >
 >>  >> Hi All,
 >>  >> these are some of the topics I think we should cover for the 2.1
 >>  >> documentation. It is not a full list so we need your help to
make it
 >>  >> as complete as possible. Pls chime in with the topics you
would like
 >>  >> to see addressed in the documentation.
 >>  >>
 >>  >> * What's new in 2.1?
 >>  >> ** New features
 >>  >> ** Component versions
 >>  >> ** Configuration changes
 >>  >> ** Backwards compatibility
 >>  >
 >>  > Hernan,
 >>  > I've fleshed out the "New Features" a bit in cwiki. Can you
explain what
 >>  > you meant by "Component versions"?
 >>  >
 >>  > --kevan
 >>  >
 >>
   

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

Jason Warner wrote:



On Fri, Feb 22, 2008 at 9:58 AM, Jason Warner <[EMAIL PROTECTED] 
> wrote:


I was looking at transferring the J2G documentation over from 2.0 to
2.1 and I noticed that j2g is listed under tools rather than a
migration heading.  Are we not going to have a Migration heading? 
I'd prefer to put the tool under something more descriptive so that

it really jumps out to a user.  Also, there were some migration
sample documents that are now left homeless.  I guess I'm wondering
if we should bring back the migration heading.  Thoughts anyone?

I'm going to go ahead and create that and then move j2g into there.  I 
can change it back if there are objections


I just replied to the first email but yes, this sounds good to me.

make sure you reflect those changes in 
http://cwiki.apache.org/confluence/display/GMOxDOC21/Apache+Geronimo+v2.1+User%27s+guide+development+status
 ;-)

Cheers!
Hernan

 



On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]
> wrote:

Lin Sun wrote:
 > Hi Hernan, I looked at the index you put out there and I
think it is
 > very good!  I cannot wait for these contents to be filled to
 > understand a bit more about these exciting 2.1 new features!!
 >
 > I think it'll be useful to add a FAQ or troubleshooting
section.   I
 > hope this can be the first place for a user to look at
whenever they
 > run into some probs/exceptions.The content can grow based
on the
 > questions we get on the user list.

At some point we had a Troubleshooting section, maybe I forgot
to bring the title over 2.1 doc. I just added the entry on the
User's guide side.
Ideally the Troubleshooting section should be a subset, an
excerpt of some of the other areas already covered. I personally
think of Troubleshooting section more like a convenience section.

Agree with you that ultimately we want to address every single
question from the user list. Hernan's view of the world!? if a
user have an issue doing a task on Geronimo that means that A) G
is not intuitive enough, B) we don't provide enough
documentation on how to perform such task, C) we do have that
info but it is a secret well kept and only a few know about it
;-) , D) all of the above.

With that said, tackling an issue on the Troubleshooting section
is a great start but we shouldn't stop there ;-)

 >
 > Also, I think the sample application and tutorial sections
are a bit
 > confusion.  First I look at the sample application and saw we
only
 > have 2 down there but then I realized most of the samples are
in the
 > tutorial section.

The User's guide on the left is somewhat a carry over of topics
from 2.0. For 2.1 I brought back the idea of the Developer's
guide and put the Tutorials section there in contrast with
Samples section from the User's guide. If you look at the
Tutorials you'll see there is a different approach, it is more
aligned with developing applications with GEP for instance,
hence the location on the Developer's guide.

Sample applications could end up being renamed to just Samples
as it included some sample configurations as well.

Either way, The doc is still on its early stages and this may
change as we continue to develop the content.

As usual, comments, new ideas and most definitively doc
contributions are always welcome


Cheers!
Hernan

 >
 > Lin
 >
 > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico
<[EMAIL PROTECTED] > wrote:
 >> Hey Kevan, Thanks for updating the doc.
 >>
 >>  I thought it would be useful for the users to know what
versions are we using for the components/projects that make
Geronimo v2.1
 >>  For example, what version of Tomcat, Jetty, Derby, Axis...
 >>
 >>  It would even help us to keep track of the components and
versions, all in one place.
 >>
 >>  Maybe this info could later on live on the Geronimo
architecture section. Once we have the info it's easier to move.
 >>
 >>  Cheers!
 >>  Hernan
 >>
 >>
 >>
 >>  Kevan Miller wrote:
 >>  >
 >>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
 >>  >
 >>  >> Hi All,
 >>  >> these are some of the topics I think we should cover for
the 2.1
 >>  >> documentation. It is not a full list so we need your
help to make it
 >>  >> as complete as possible. Pls chime

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

J2G ended up under tooling because that's how we have it organized on the web 
site
Development tools
   + Geronimo Eclipse Plugin
   + JBoss to Geronimo Migration Tool (J2G)

Just trying to remain consistent. We can definitively create a Migration 
section, move j2g there as well as updating all the previous migration examples 
we used to have on the previous releases.

Moving the content within the same confluence space is really easy.

Cheers!
Hernan

Jason Warner wrote:
I was looking at transferring the J2G documentation over from 2.0 to 2.1 
and I noticed that j2g is listed under tools rather than a migration 
heading.  Are we not going to have a Migration heading?  I'd prefer to 
put the tool under something more descriptive so that it really jumps 
out to a user.  Also, there were some migration sample documents that 
are now left homeless.  I guess I'm wondering if we should bring back 
the migration heading.  Thoughts anyone?


On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED] 
> wrote:


Lin Sun wrote:
 > Hi Hernan, I looked at the index you put out there and I think it is
 > very good!  I cannot wait for these contents to be filled to
 > understand a bit more about these exciting 2.1 new features!!
 >
 > I think it'll be useful to add a FAQ or troubleshooting section.   I
 > hope this can be the first place for a user to look at whenever they
 > run into some probs/exceptions.The content can grow based on the
 > questions we get on the user list.

At some point we had a Troubleshooting section, maybe I forgot to
bring the title over 2.1 doc. I just added the entry on the User's
guide side.
Ideally the Troubleshooting section should be a subset, an excerpt
of some of the other areas already covered. I personally think of
Troubleshooting section more like a convenience section.

Agree with you that ultimately we want to address every single
question from the user list. Hernan's view of the world!? if a user
have an issue doing a task on Geronimo that means that A) G is not
intuitive enough, B) we don't provide enough documentation on how to
perform such task, C) we do have that info but it is a secret well
kept and only a few know about it ;-) , D) all of the above.

With that said, tackling an issue on the Troubleshooting section is
a great start but we shouldn't stop there ;-)

 >
 > Also, I think the sample application and tutorial sections are a bit
 > confusion.  First I look at the sample application and saw we only
 > have 2 down there but then I realized most of the samples are in the
 > tutorial section.

The User's guide on the left is somewhat a carry over of topics from
2.0. For 2.1 I brought back the idea of the Developer's guide and
put the Tutorials section there in contrast with Samples section
from the User's guide. If you look at the Tutorials you'll see there
is a different approach, it is more aligned with developing
applications with GEP for instance, hence the location on the
Developer's guide.

Sample applications could end up being renamed to just Samples as it
included some sample configurations as well.

Either way, The doc is still on its early stages and this may change
as we continue to develop the content.

As usual, comments, new ideas and most definitively doc
contributions are always welcome


Cheers!
Hernan

 >
 > Lin
 >
 > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico
<[EMAIL PROTECTED] > wrote:
 >> Hey Kevan, Thanks for updating the doc.
 >>
 >>  I thought it would be useful for the users to know what
versions are we using for the components/projects that make Geronimo
v2.1
 >>  For example, what version of Tomcat, Jetty, Derby, Axis...
 >>
 >>  It would even help us to keep track of the components and
versions, all in one place.
 >>
 >>  Maybe this info could later on live on the Geronimo
architecture section. Once we have the info it's easier to move.
 >>
 >>  Cheers!
 >>  Hernan
 >>
 >>
 >>
 >>  Kevan Miller wrote:
 >>  >
 >>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
 >>  >
 >>  >> Hi All,
 >>  >> these are some of the topics I think we should cover for the 2.1
 >>  >> documentation. It is not a full list so we need your help to
make it
 >>  >> as complete as possible. Pls chime in with the topics you
would like
 >>  >> to see addressed in the documentation.
 >>  >>
 >>  >> * What's new in 2.1?
 >>  >> ** New features
 >>  >> ** Component versions
 >>  >> ** Configuration changes
 >>  >> ** Backwards compatibility
 >>  >
 >>  > Hernan,
 >>  > I've fleshed out the "New Features" a bit in cwiki. Can you
explain

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

On Fri, Feb 22, 2008 at 9:58 AM, Jason Warner <[EMAIL PROTECTED]> wrote:

> I was looking at transferring the J2G documentation over from 2.0 to 2.1and I 
> noticed that j2g is listed under tools rather than a migration
> heading.  Are we not going to have a Migration heading?  I'd prefer to put
> the tool under something more descriptive so that it really jumps out to a
> user.  Also, there were some migration sample documents that are now left
> homeless.  I guess I'm wondering if we should bring back the migration
> heading.  Thoughts anyone?
>
> I'm going to go ahead and create that and then move j2g into there.  I can
change it back if there are objections


>
> On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]> wrote:
>
> > Lin Sun wrote:
> > > Hi Hernan, I looked at the index you put out there and I think it is
> > > very good!  I cannot wait for these contents to be filled to
> > > understand a bit more about these exciting 2.1 new features!!
> > >
> > > I think it'll be useful to add a FAQ or troubleshooting section.   I
> > > hope this can be the first place for a user to look at whenever they
> > > run into some probs/exceptions.The content can grow based on the
> > > questions we get on the user list.
> >
> > At some point we had a Troubleshooting section, maybe I forgot to bring
> > the title over 2.1 doc. I just added the entry on the User's guide side.
> > Ideally the Troubleshooting section should be a subset, an excerpt of
> > some of the other areas already covered. I personally think of
> > Troubleshooting section more like a convenience section.
> >
> > Agree with you that ultimately we want to address every single question
> > from the user list. Hernan's view of the world!? if a user have an issue
> > doing a task on Geronimo that means that A) G is not intuitive enough, B) we
> > don't provide enough documentation on how to perform such task, C) we do
> > have that info but it is a secret well kept and only a few know about it ;-)
> > , D) all of the above.
> >
> > With that said, tackling an issue on the Troubleshooting section is a
> > great start but we shouldn't stop there ;-)
> >
> > >
> > > Also, I think the sample application and tutorial sections are a bit
> > > confusion.  First I look at the sample application and saw we only
> > > have 2 down there but then I realized most of the samples are in the
> > > tutorial section.
> >
> > The User's guide on the left is somewhat a carry over of topics from 2.0.
> > For 2.1 I brought back the idea of the Developer's guide and put the
> > Tutorials section there in contrast with Samples section from the User's
> > guide. If you look at the Tutorials you'll see there is a different
> > approach, it is more aligned with developing applications with GEP for
> > instance, hence the location on the Developer's guide.
> >
> > Sample applications could end up being renamed to just Samples as it
> > included some sample configurations as well.
> >
> > Either way, The doc is still on its early stages and this may change as
> > we continue to develop the content.
> >
> > As usual, comments, new ideas and most definitively doc contributions
> > are always welcome
> >
> >
> > Cheers!
> > Hernan
> >
> > >
> > > Lin
> > >
> > > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico <[EMAIL PROTECTED]>
> > wrote:
> > >> Hey Kevan, Thanks for updating the doc.
> > >>
> > >>  I thought it would be useful for the users to know what versions are
> > we using for the components/projects that make Geronimo v2.1
> > >>  For example, what version of Tomcat, Jetty, Derby, Axis...
> > >>
> > >>  It would even help us to keep track of the components and versions,
> > all in one place.
> > >>
> > >>  Maybe this info could later on live on the Geronimo architecture
> > section. Once we have the info it's easier to move.
> > >>
> > >>  Cheers!
> > >>  Hernan
> > >>
> > >>
> > >>
> > >>  Kevan Miller wrote:
> > >>  >
> > >>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
> > >>  >
> > >>  >> Hi All,
> > >>  >> these are some of the topics I think we should cover for the 2.1
> > >>  >> documentation. It is not a full list so we need your help to make
> > it
> > >>  >> as complete as possible. Pls chime in with the topics you would
> > like
> > >>  >> to see addressed in the documentation.
> > >>  >>
> > >>  >> * What's new in 2.1?
> > >>  >> ** New features
> > >>  >> ** Component versions
> > >>  >> ** Configuration changes
> > >>  >> ** Backwards compatibility
> > >>  >
> > >>  > Hernan,
> > >>  > I've fleshed out the "New Features" a bit in cwiki. Can you
> > explain what
> > >>  > you meant by "Component versions"?
> > >>  >
> > >>  > --kevan
> > >>  >
> > >>
> > >
> >
>
>
>
> --
> ~Jason Warner




-- 
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Jason Warner]

I was looking at transferring the J2G documentation over from 2.0 to 2.1 and
I noticed that j2g is listed under tools rather than a migration heading.
Are we not going to have a Migration heading?  I'd prefer to put the tool
under something more descriptive so that it really jumps out to a user.
Also, there were some migration sample documents that are now left
homeless.  I guess I'm wondering if we should bring back the migration
heading.  Thoughts anyone?

On Thu, Feb 21, 2008 at 1:49 PM, Hernan Cunico <[EMAIL PROTECTED]> wrote:

> Lin Sun wrote:
> > Hi Hernan, I looked at the index you put out there and I think it is
> > very good!  I cannot wait for these contents to be filled to
> > understand a bit more about these exciting 2.1 new features!!
> >
> > I think it'll be useful to add a FAQ or troubleshooting section.   I
> > hope this can be the first place for a user to look at whenever they
> > run into some probs/exceptions.The content can grow based on the
> > questions we get on the user list.
>
> At some point we had a Troubleshooting section, maybe I forgot to bring
> the title over 2.1 doc. I just added the entry on the User's guide side.
> Ideally the Troubleshooting section should be a subset, an excerpt of some
> of the other areas already covered. I personally think of Troubleshooting
> section more like a convenience section.
>
> Agree with you that ultimately we want to address every single question
> from the user list. Hernan's view of the world!? if a user have an issue
> doing a task on Geronimo that means that A) G is not intuitive enough, B) we
> don't provide enough documentation on how to perform such task, C) we do
> have that info but it is a secret well kept and only a few know about it ;-)
> , D) all of the above.
>
> With that said, tackling an issue on the Troubleshooting section is a
> great start but we shouldn't stop there ;-)
>
> >
> > Also, I think the sample application and tutorial sections are a bit
> > confusion.  First I look at the sample application and saw we only
> > have 2 down there but then I realized most of the samples are in the
> > tutorial section.
>
> The User's guide on the left is somewhat a carry over of topics from 2.0.
> For 2.1 I brought back the idea of the Developer's guide and put the
> Tutorials section there in contrast with Samples section from the User's
> guide. If you look at the Tutorials you'll see there is a different
> approach, it is more aligned with developing applications with GEP for
> instance, hence the location on the Developer's guide.
>
> Sample applications could end up being renamed to just Samples as it
> included some sample configurations as well.
>
> Either way, The doc is still on its early stages and this may change as we
> continue to develop the content.
>
> As usual, comments, new ideas and most definitively doc contributions are
> always welcome
>
>
> Cheers!
> Hernan
>
> >
> > Lin
> >
> > On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico <[EMAIL PROTECTED]>
> wrote:
> >> Hey Kevan, Thanks for updating the doc.
> >>
> >>  I thought it would be useful for the users to know what versions are
> we using for the components/projects that make Geronimo v2.1
> >>  For example, what version of Tomcat, Jetty, Derby, Axis...
> >>
> >>  It would even help us to keep track of the components and versions,
> all in one place.
> >>
> >>  Maybe this info could later on live on the Geronimo architecture
> section. Once we have the info it's easier to move.
> >>
> >>  Cheers!
> >>  Hernan
> >>
> >>
> >>
> >>  Kevan Miller wrote:
> >>  >
> >>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
> >>  >
> >>  >> Hi All,
> >>  >> these are some of the topics I think we should cover for the 2.1
> >>  >> documentation. It is not a full list so we need your help to make
> it
> >>  >> as complete as possible. Pls chime in with the topics you would
> like
> >>  >> to see addressed in the documentation.
> >>  >>
> >>  >> * What's new in 2.1?
> >>  >> ** New features
> >>  >> ** Component versions
> >>  >> ** Configuration changes
> >>  >> ** Backwards compatibility
> >>  >
> >>  > Hernan,
> >>  > I've fleshed out the "New Features" a bit in cwiki. Can you explain
> what
> >>  > you meant by "Component versions"?
> >>  >
> >>  > --kevan
> >>  >
> >>
> >
>



-- 
~Jason Warner

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

Lin Sun wrote:

Hi Hernan, I looked at the index you put out there and I think it is
very good!  I cannot wait for these contents to be filled to
understand a bit more about these exciting 2.1 new features!!

I think it'll be useful to add a FAQ or troubleshooting section.   I
hope this can be the first place for a user to look at whenever they
run into some probs/exceptions.The content can grow based on the
questions we get on the user list.


At some point we had a Troubleshooting section, maybe I forgot to bring the 
title over 2.1 doc. I just added the entry on the User's guide side.
Ideally the Troubleshooting section should be a subset, an excerpt of some of 
the other areas already covered. I personally think of Troubleshooting section 
more like a convenience section.

Agree with you that ultimately we want to address every single question from 
the user list. Hernan's view of the world!? if a user have an issue doing a 
task on Geronimo that means that A) G is not intuitive enough, B) we don't 
provide enough documentation on how to perform such task, C) we do have that 
info but it is a secret well kept and only a few know about it ;-) , D) all of 
the above.

With that said, tackling an issue on the Troubleshooting section is a great 
start but we shouldn't stop there ;-)



Also, I think the sample application and tutorial sections are a bit
confusion.  First I look at the sample application and saw we only
have 2 down there but then I realized most of the samples are in the
tutorial section.


The User's guide on the left is somewhat a carry over of topics from 2.0. For 
2.1 I brought back the idea of the Developer's guide and put the Tutorials 
section there in contrast with Samples section from the User's guide. If you 
look at the Tutorials you'll see there is a different approach, it is more 
aligned with developing applications with GEP for instance, hence the location 
on the Developer's guide.

Sample applications could end up being renamed to just Samples as it included 
some sample configurations as well.

Either way, The doc is still on its early stages and this may change as we 
continue to develop the content.

As usual, comments, new ideas and most definitively doc contributions are 
always welcome


Cheers!
Hernan



Lin

On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico <[EMAIL PROTECTED]> wrote:

Hey Kevan, Thanks for updating the doc.

 I thought it would be useful for the users to know what versions are we using 
for the components/projects that make Geronimo v2.1
 For example, what version of Tomcat, Jetty, Derby, Axis...

 It would even help us to keep track of the components and versions, all in one 
place.

 Maybe this info could later on live on the Geronimo architecture section. Once 
we have the info it's easier to move.

 Cheers!
 Hernan



 Kevan Miller wrote:
 >
 > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
 >
 >> Hi All,
 >> these are some of the topics I think we should cover for the 2.1
 >> documentation. It is not a full list so we need your help to make it
 >> as complete as possible. Pls chime in with the topics you would like
 >> to see addressed in the documentation.
 >>
 >> * What's new in 2.1?
 >> ** New features
 >> ** Component versions
 >> ** Configuration changes
 >> ** Backwards compatibility
 >
 > Hernan,
 > I've fleshed out the "New Features" a bit in cwiki. Can you explain what
 > you meant by "Component versions"?
 >
 > --kevan
 >

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Lin Sun]

Hi Hernan, I looked at the index you put out there and I think it is
very good!  I cannot wait for these contents to be filled to
understand a bit more about these exciting 2.1 new features!!

I think it'll be useful to add a FAQ or troubleshooting section.   I
hope this can be the first place for a user to look at whenever they
run into some probs/exceptions.The content can grow based on the
questions we get on the user list.

Also, I think the sample application and tutorial sections are a bit
confusion.  First I look at the sample application and saw we only
have 2 down there but then I realized most of the samples are in the
tutorial section.

Lin

On Mon, Feb 18, 2008 at 10:23 AM, Hernan Cunico <[EMAIL PROTECTED]> wrote:
> Hey Kevan, Thanks for updating the doc.
>
>  I thought it would be useful for the users to know what versions are we 
> using for the components/projects that make Geronimo v2.1
>  For example, what version of Tomcat, Jetty, Derby, Axis...
>
>  It would even help us to keep track of the components and versions, all in 
> one place.
>
>  Maybe this info could later on live on the Geronimo architecture section. 
> Once we have the info it's easier to move.
>
>  Cheers!
>  Hernan
>
>
>
>  Kevan Miller wrote:
>  >
>  > On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:
>  >
>  >> Hi All,
>  >> these are some of the topics I think we should cover for the 2.1
>  >> documentation. It is not a full list so we need your help to make it
>  >> as complete as possible. Pls chime in with the topics you would like
>  >> to see addressed in the documentation.
>  >>
>  >> * What's new in 2.1?
>  >> ** New features
>  >> ** Component versions
>  >> ** Configuration changes
>  >> ** Backwards compatibility
>  >
>  > Hernan,
>  > I've fleshed out the "New Features" a bit in cwiki. Can you explain what
>  > you meant by "Component versions"?
>  >
>  > --kevan
>  >
>

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Hernan Cunico]

Hey Kevan, Thanks for updating the doc.

I thought it would be useful for the users to know what versions are we using 
for the components/projects that make Geronimo v2.1
For example, what version of Tomcat, Jetty, Derby, Axis... 


It would even help us to keep track of the components and versions, all in one 
place.

Maybe this info could later on live on the Geronimo architecture section. Once 
we have the info it's easier to move.

Cheers!
Hernan

Kevan Miller wrote:


On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:


Hi All,
these are some of the topics I think we should cover for the 2.1 
documentation. It is not a full list so we need your help to make it 
as complete as possible. Pls chime in with the topics you would like 
to see addressed in the documentation.


* What's new in 2.1?
** New features
** Component versions
** Configuration changes
** Backwards compatibility


Hernan,
I've fleshed out the "New Features" a bit in cwiki. Can you explain what 
you meant by "Component versions"?


--kevan

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Kevan Miller]

On Jan 28, 2008, at 11:48 AM, Hernan Cunico wrote:


Hi All,
these are some of the topics I think we should cover for the 2.1  
documentation. It is not a full list so we need your help to make it  
as complete as possible. Pls chime in with the topics you would like  
to see addressed in the documentation.


* What's new in 2.1?
** New features
** Component versions
** Configuration changes
** Backwards compatibility


Hernan,
I've fleshed out the "New Features" a bit in cwiki. Can you explain  
what you meant by "Component versions"?


--kevan

Re: [DISCUSSION] Geronimo v2.1 documentation - Content

[Erik B. Craig]

Hernan,

I have been working on the monitoring documentation, once finished  
with that, I can take up the J2G as well if you would like



Thanks,
Erik B. Craig
[EMAIL PROTECTED]




On Jan 28, 2008, at 10:48 AM, Hernan Cunico wrote:


Hi All,
these are some of the topics I think we should cover for the 2.1  
documentation. It is not a full list so we need your help to make it  
as complete as possible. Pls chime in with the topics you would like  
to see addressed in the documentation.


* What's new in 2.1?
** New features
** Component versions
** Configuration changes
** Backwards compatibility

* Geronimo architecture
** GBeans
** Subprojects
** Components
*** Distributions
** Repositories
** Configuration
** Customize the server

* Installation
** Planning
** Binary
** Source
** Configuration
*** Ports interaction
*** Repositories
*** Logging
*** Security

* Deployment
** What changed?
** New deployment options
*** Command line - standard
*** Command line - GShell
*** Plugins
*** Console
  Deployment plan wizard

* Geronimo Administration Console ** What changed?
** Console enhancements
** The pluggable console
** Expert mode
** Deployment plans wizard
** CA helper

* GShell
** What is it?
** Benefits
** What it does/replaces
** Tools and commands
** How-to samples

* Monitoring
** What is it?
** What can I monitor
** Impact on the server workload?
** Install
** Customization

* Pluggable console
** What is it?
** Benefits
** Architecture
** Install/deploy
** Customization
** Developing new portlets

* Plugin infrastructure ** What are the plugins?
** Enhancements from previous releases
** Plugin infrastructure/architecture
** plugin.xml
** Plugins install
** Pluggable console
** GShell commands option

* Security
** Enhancements
** Planning
** Configuration

* Tooling
** Devtools
*** Geronimo eclipse plugin
** j2g

* Clustering

* Sample applications

* Tutorials

Now that you see this list we also need your help to *develop* some  
of these topics. Pls chime in.


Cheers!
Hernan