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
