Re: Update on documentation progress of Geronimo v2.2

[Ying Tang]

Hi all,

The restructuring work for Geronimo 2.2
documentshas
drawn to an end. Please feel free to write about the new
features,
or any topic that you are interested in. And please keep everyone in the
loop if you make changes. Thanks.

Topics for advanced users have been labeled by the information mark (i).
They are kept where they were, as we guess Geronimo 2.2 probably has more
advanced topics. When the new topics are completed, all the advanced ones
will be moved to a separated section. Your comments are highly appreciated.


Thanks and Regards,
Ying Tang (Sophia)

Re: Update on documentation progress of Geronimo v2.2

[Donald Woods]

I still think these topics are more geared towards developers...

As long as we cover using the console/gshell in the Admin section and 
leave all maven related usage to the developer section (and note that 
this is only for advanced users), then I'm fine with keeping them in the 
2.2 User Docs.



-Donald


RunHua Chi wrote:

Thanks David for your comments.

I guess we have some different understandings regarding "Users" of
Geronimo.My understanding is that Geronimo is an application server and its
primary user would be application developers. While they might need to know
what a plugin or a gbean is in Geronimo but don't have to build the source
code. That's where my proposal comes from. And mostly they would read
GMOxDOC to learn how to utilize Geronimo for their application development.

And we have another group of "Users"(actually I'd rather call them
"developers" ^_^), they are more interested in Geronimo structure, kernel
and keen on breakthroughs. In my understanding, they would go to GMOXDEV for
more information. 

Any other ideas, please speak up. :) 


Jeff



djencks wrote:


On Dec 3, 2008, at 5:55 PM, RunHua Chi wrote:

Do we need to move following topics to GMOXDEV as they are also  
about how to

build

1. build a plugin as part of a maven build using the car-maven-plugin.
2. install a plugin using the car-maven-plugin
3. Assembling a server using Maven
These all need to stay in the regular documentation.  We expect many  
users to do all these activities every day, even if they don't build  
geronimo.


thanks
david jencks


If the answer is yes. Maybe we could have a page to collect all  
informations
on how to build with maven at GMOXDEV?So far, I have some topics  
coming up

my mind:

a. build Geronimo source code;
b. build/install a plugin using car-maven-plugin;
c. build a new server from the existing one;
d. build GEP
..and more

Any comments?

Jeff



Donald Woods-2 wrote:

Agree.  Using the eclipse/build.xml file from svn should go in the
GMOxDEV space, as that is really only for developers.  Maybe we could
include a Note and pointer over to the Dev docs for anyone who is
interested in using it.


-Donald

Re: Update on documentation progress of Geronimo v2.2

[Jack Cai]

I agree with David J. that 1, 2 and 3 should stay in the user doc, maybe as
advanced topics.

-Jack


2008/12/4 RunHua Chi <[EMAIL PROTECTED]>

>
> Thanks David for your comments.
>
> I guess we have some different understandings regarding "Users" of
> Geronimo.My understanding is that Geronimo is an application server and its
> primary user would be application developers. While they might need to know
> what a plugin or a gbean is in Geronimo but don't have to build the source
> code. That's where my proposal comes from. And mostly they would read
> GMOxDOC to learn how to utilize Geronimo for their application development.
>
> And we have another group of "Users"(actually I'd rather call them
> "developers" ^_^), they are more interested in Geronimo structure, kernel
> and keen on breakthroughs. In my understanding, they would go to GMOXDEV
> for
> more information.
>
> Any other ideas, please speak up. :)
>
> Jeff
>
>
>
> djencks wrote:
> >
> >
> > On Dec 3, 2008, at 5:55 PM, RunHua Chi wrote:
> >
> >>
> >> Do we need to move following topics to GMOXDEV as they are also
> >> about how to
> >> build
> >>
> >> 1. build a plugin as part of a maven build using the car-maven-plugin.
> >> 2. install a plugin using the car-maven-plugin
> >> 3. Assembling a server using Maven
> >
> > These all need to stay in the regular documentation.  We expect many
> > users to do all these activities every day, even if they don't build
> > geronimo.
> >
> > thanks
> > david jencks
> >>
> >>
> >> If the answer is yes. Maybe we could have a page to collect all
> >> informations
> >> on how to build with maven at GMOXDEV?So far, I have some topics
> >> coming up
> >> my mind:
> >>
> >> a. build Geronimo source code;
> >> b. build/install a plugin using car-maven-plugin;
> >> c. build a new server from the existing one;
> >> d. build GEP
> >> ..and more
> >>
> >> Any comments?
> >>
> >> Jeff
> >>
> >>
> >>
> >> Donald Woods-2 wrote:
> >>>
> >>> Agree.  Using the eclipse/build.xml file from svn should go in the
> >>> GMOxDEV space, as that is really only for developers.  Maybe we could
> >>> include a Note and pointer over to the Dev docs for anyone who is
> >>> interested in using it.
> >>>
> >>>
> >>> -Donald
> >>>
> >>>
> >
>
> --
> View this message in context:
> http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20830014.html
> Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com.
>
>

Re: Update on documentation progress of Geronimo v2.2

[David Jencks]

On Dec 4, 2008, at 1:35 AM, RunHua Chi wrote:



Thanks David for your comments.

I guess we have some different understandings regarding "Users" of
Geronimo.My understanding is that Geronimo is an application server  
and its
primary user would be application developers. While they might need  
to know
what a plugin or a gbean is in Geronimo but don't have to build the  
source

code. That's where my proposal comes from. And mostly they would read
GMOxDOC to learn how to utilize Geronimo for their application  
development.


And we have another group of "Users"(actually I'd rather call them
"developers" ^_^), they are more interested in Geronimo structure,  
kernel
and keen on breakthroughs. In my understanding, they would go to  
GMOXDEV for

more information.

Any other ideas, please speak up. :)


To me, the preferred way of using geronimo for anything other than  
experimentation with toy apps is to use your build system to build  
your apps, package them as geronimo plugins, and build a custom server  
assembly including your apps.  I'd prefer if the documentation clearly  
reflect this approach.  In any case I think anything relevant to this  
approach needs to be in the 2.2 docs.


thanks
david jencks




Jeff



djencks wrote:



On Dec 3, 2008, at 5:55 PM, RunHua Chi wrote:



Do we need to move following topics to GMOXDEV as they are also
about how to
build

1. build a plugin as part of a maven build using the car-maven- 
plugin.

2. install a plugin using the car-maven-plugin
3. Assembling a server using Maven


These all need to stay in the regular documentation.  We expect many
users to do all these activities every day, even if they don't build
geronimo.

thanks
david jencks



If the answer is yes. Maybe we could have a page to collect all
informations
on how to build with maven at GMOXDEV?So far, I have some topics
coming up
my mind:

a. build Geronimo source code;
b. build/install a plugin using car-maven-plugin;
c. build a new server from the existing one;
d. build GEP
..and more

Any comments?

Jeff



Donald Woods-2 wrote:


Agree.  Using the eclipse/build.xml file from svn should go in the
GMOxDEV space, as that is really only for developers.  Maybe we  
could

include a Note and pointer over to the Dev docs for anyone who is
interested in using it.


-Donald






--
View this message in context: 
http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20830014.html
Sent from the Apache Geronimo - Dev mailing list archive at  
Nabble.com.

Re: Update on documentation progress of Geronimo v2.2

[RunHua Chi]

Thanks David for your comments.

I guess we have some different understandings regarding "Users" of
Geronimo.My understanding is that Geronimo is an application server and its
primary user would be application developers. While they might need to know
what a plugin or a gbean is in Geronimo but don't have to build the source
code. That's where my proposal comes from. And mostly they would read
GMOxDOC to learn how to utilize Geronimo for their application development.

And we have another group of "Users"(actually I'd rather call them
"developers" ^_^), they are more interested in Geronimo structure, kernel
and keen on breakthroughs. In my understanding, they would go to GMOXDEV for
more information. 

Any other ideas, please speak up. :) 

Jeff



djencks wrote:
> 
> 
> On Dec 3, 2008, at 5:55 PM, RunHua Chi wrote:
> 
>>
>> Do we need to move following topics to GMOXDEV as they are also  
>> about how to
>> build
>>
>> 1. build a plugin as part of a maven build using the car-maven-plugin.
>> 2. install a plugin using the car-maven-plugin
>> 3. Assembling a server using Maven
> 
> These all need to stay in the regular documentation.  We expect many  
> users to do all these activities every day, even if they don't build  
> geronimo.
> 
> thanks
> david jencks
>>
>>
>> If the answer is yes. Maybe we could have a page to collect all  
>> informations
>> on how to build with maven at GMOXDEV?So far, I have some topics  
>> coming up
>> my mind:
>>
>> a. build Geronimo source code;
>> b. build/install a plugin using car-maven-plugin;
>> c. build a new server from the existing one;
>> d. build GEP
>> ..and more
>>
>> Any comments?
>>
>> Jeff
>>
>>
>>
>> Donald Woods-2 wrote:
>>>
>>> Agree.  Using the eclipse/build.xml file from svn should go in the
>>> GMOxDEV space, as that is really only for developers.  Maybe we could
>>> include a Note and pointer over to the Dev docs for anyone who is
>>> interested in using it.
>>>
>>>
>>> -Donald
>>>
>>>
> 

-- 
View this message in context: 
http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20830014.html
Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com.

Re: Update on documentation progress of Geronimo v2.2

[David Jencks]

On Dec 3, 2008, at 5:55 PM, RunHua Chi wrote:



Do we need to move following topics to GMOXDEV as they are also  
about how to

build

1. build a plugin as part of a maven build using the car-maven-plugin.
2. install a plugin using the car-maven-plugin
3. Assembling a server using Maven


These all need to stay in the regular documentation.  We expect many  
users to do all these activities every day, even if they don't build  
geronimo.


thanks
david jencks



If the answer is yes. Maybe we could have a page to collect all  
informations
on how to build with maven at GMOXDEV?So far, I have some topics  
coming up

my mind:

a. build Geronimo source code;
b. build/install a plugin using car-maven-plugin;
c. build a new server from the existing one;
d. build GEP
..and more

Any comments?

Jeff



Donald Woods-2 wrote:


Agree.  Using the eclipse/build.xml file from svn should go in the
GMOxDEV space, as that is really only for developers.  Maybe we could
include a Note and pointer over to the Dev docs for anyone who is
interested in using it.


-Donald


Delos wrote:

Hi

About "Installing Eclipse using Ant script from GEP build", I  
think the

build process should be transparent to users. So I suggest to remove
this section, since it's more convenient for user to download  
eclipse

from eclipse site.

Any comments?

2008/11/28 Ying Tang <[EMAIL PROTECTED]
>

   Hi all,

 The Installing Eclipse
     
page in

   Development environment
   
   section has been updated. Major changes include:

   1.  The first section "Installing Eclipse in an All-in-one  
Package"
   has been changed into "Installing Eclipse for Java EE  
Developers".


   2.  The second section "Install Eclipse and WTP separately" has  
been

   divided into "Installing manually" and "Installing using Update
   Manager". Europa and Ganymede are talked about separately. New
   snapshots are added.

   Your comments are highly appreciated.



 Thanks and Regards,

 Ying Tang (Sophia)







--
View this message in context: 
http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20825778.html
Sent from the Apache Geronimo - Dev mailing list archive at  
Nabble.com.

Re: Update on documentation progress of Geronimo v2.2

[RunHua Chi]

Do we need to move following topics to GMOXDEV as they are also about how to
build

1. build a plugin as part of a maven build using the car-maven-plugin. 
2. install a plugin using the car-maven-plugin
3. Assembling a server using Maven 

If the answer is yes. Maybe we could have a page to collect all informations
on how to build with maven at GMOXDEV?So far, I have some topics coming up
my mind:

a. build Geronimo source code;
b. build/install a plugin using car-maven-plugin;
c. build a new server from the existing one;
d. build GEP
..and more

Any comments?

Jeff



Donald Woods-2 wrote:
> 
> Agree.  Using the eclipse/build.xml file from svn should go in the 
> GMOxDEV space, as that is really only for developers.  Maybe we could 
> include a Note and pointer over to the Dev docs for anyone who is 
> interested in using it.
> 
> 
> -Donald
> 
> 
> Delos wrote:
>> Hi
>> 
>> About "Installing Eclipse using Ant script from GEP build", I think the 
>> build process should be transparent to users. So I suggest to remove 
>> this section, since it's more convenient for user to download eclipse 
>> from eclipse site.
>> 
>> Any comments?
>> 
>> 2008/11/28 Ying Tang <[EMAIL PROTECTED] 
>> >
>> 
>> Hi all,
>> 
>>   The Installing Eclipse
>>  page in
>> Development environment
>> 
>> section has been updated. Major changes include:
>>  
>> 1.  The first section "Installing Eclipse in an All-in-one Package"
>> has been changed into "Installing Eclipse for Java EE Developers".
>> 
>> 2.  The second section "Install Eclipse and WTP separately" has been
>> divided into "Installing manually" and "Installing using Update
>> Manager". Europa and Ganymede are talked about separately. New
>> snapshots are added.
>> 
>> Your comments are highly appreciated.
>> 
>>  
>> 
>>   Thanks and Regards,  
>> 
>>   Ying Tang (Sophia)
>> 
>> 
> 
> 

-- 
View this message in context: 
http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20825778.html
Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com.

Re: Update on documentation progress of Geronimo v2.2

[Donald Woods]

Agree.  Using the eclipse/build.xml file from svn should go in the 
GMOxDEV space, as that is really only for developers.  Maybe we could 
include a Note and pointer over to the Dev docs for anyone who is 
interested in using it.



-Donald


Delos wrote:

Hi

About "Installing Eclipse using Ant script from GEP build", I think the 
build process should be transparent to users. So I suggest to remove 
this section, since it's more convenient for user to download eclipse 
from eclipse site.


Any comments?

2008/11/28 Ying Tang <[EMAIL PROTECTED] 
>


Hi all,

  The Installing Eclipse
 page in
Development environment

section has been updated. Major changes include:
 
1.  The first section "Installing Eclipse in an All-in-one Package"

has been changed into "Installing Eclipse for Java EE Developers".

2.  The second section "Install Eclipse and WTP separately" has been
divided into "Installing manually" and "Installing using Update
Manager". Europa and Ganymede are talked about separately. New
snapshots are added.

Your comments are highly appreciated.

 

  Thanks and Regards,  


  Ying Tang (Sophia)

Re: Update on documentation progress of Geronimo v2.2

[Jack Cai]

Thanks Jeff and Ying! I like the current 2.2 doc overall structure. It's
really task-oriented and easy to consume. It's just that we still have a lot
of TODO items. :-) Still way to go, but very glad to see the progress!

- Jack


2008/11/28 RunHua Chi <[EMAIL PROTECTED]>

>
> Thanks Ted, SunLin and Donnald for your update and comments on Doc.
>
> This week, we are working on page-merge and content deduplication in order
> for better usability.
>
> Major items include:
>
> 1. Remove duplication content between "Quick Start" and "Installing and
> Running" chapters;
>
> For example,  3 types of G assemblies configuration were introuduced twice,
> so we remove the content from "Quick start" chapter and keep detail
> description in another place.
>
>
> 2.  Join some certain topics within one page
>
> For example,  "Starting server via Console" and "Starting via Gshell" are 2
> leaves upon one task, another both are really short ones,  so we put them
> together by including 2 leaves.   But we still keep both leaves as is for
> future reuse.
>
>
> For more details on the changes to "Quick Start" and "installing and
> Running" chapter, please look into status page as below.
>
>
> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status
>
>
> Next week, we'll move forward to the next chapter "Configuring and
> administering". Any comments are welcome. Anyone who wants to start writing
> new feature or enhancement, please go ahead.
>
> Jeff
>
>
>
>
>
> Ted Kirby-2 wrote:
> >
> > Thanks Sophia.  I consolidated some GEP installation pages to one page
> > on the status page.
> >
> > Ted Kirby
> >
> > On Fri, Nov 21, 2008 at 2:34 AM, Ying Tang <[EMAIL PROTECTED]>
> wrote:
> >>> Hi all,
> >>>
> >>>By the end of this week, we have almost finished refining the
> >>> structure
> >>> for Geronimo 2.2 documents, by dividing pages with multiple topics into
> >>> separate pages, and moving pages to their appropriate parents.
> Meanwhile
> >>> we
> >>> are making incremental changes, importing information from the
> >>> development
> >>> documents.
> >>>
> >>>Any of your comments on the structure or topics are appreciated. We
> >>> hope more people can chime in and write about your favorite new topics,
> >>> for
> >>> example, plugin profiles, and server cluster management.
> >>>
> >>>The documentation status is kept here:
> >>>
> >>>
> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status
> >>
> >>
> >> Thanks and Regards,
> >>
> >> Ying Tang (Sophia)
> >>
> >>
> >
> >
>
> --
> View this message in context:
> http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20730864.html
> Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com.
>
>

Re: Update on documentation progress of Geronimo v2.2

[Delos]

Hi

About "Installing Eclipse using Ant script from GEP build", I think the
build process should be transparent to users. So I suggest to remove this
section, since it's more convenient for user to download eclipse from
eclipse site.

Any comments?

2008/11/28 Ying Tang <[EMAIL PROTECTED]>

> Hi all,
>
>   The Installing 
> Eclipsepage in 
> Development
> environmentsection
>  has been updated. Major changes include:
>
> 1.  The first section "Installing Eclipse in an All-in-one Package" has
> been changed into "Installing Eclipse for Java EE Developers".
>
> 2.  The second section "Install Eclipse and WTP separately" has been
> divided into "Installing manually" and "Installing using Update Manager".
> Europa and Ganymede are talked about separately. New snapshots are added.
>
> Your comments are highly appreciated.
>
>
>
>   Thanks and Regards,
>
>   Ying Tang (Sophia)
>

Re: Update on documentation progress of Geronimo v2.2

[Ying Tang]

 Hi all,

  The Installing
Eclipsepage
in Development
environment 
section
has been updated. Major changes include:

1.  The first section "Installing Eclipse in an All-in-one Package" has been
changed into "Installing Eclipse for Java EE Developers".

2.  The second section "Install Eclipse and WTP separately" has been divided
into "Installing manually" and "Installing using Update Manager". Europa and
Ganymede are talked about separately. New snapshots are added.

Your comments are highly appreciated.


  Thanks and Regards,

  Ying Tang (Sophia)

Re: Update on documentation progress of Geronimo v2.2

[RunHua Chi]

Thanks Ted, SunLin and Donnald for your update and comments on Doc.

This week, we are working on page-merge and content deduplication in order
for better usability.

Major items include:

1. Remove duplication content between "Quick Start" and "Installing and
Running" chapters;

For example,  3 types of G assemblies configuration were introuduced twice,
so we remove the content from "Quick start" chapter and keep detail
description in another place.


2.  Join some certain topics within one page

For example,  "Starting server via Console" and "Starting via Gshell" are 2
leaves upon one task, another both are really short ones,  so we put them
together by including 2 leaves.   But we still keep both leaves as is for
future reuse.


For more details on the changes to "Quick Start" and "installing and
Running" chapter, please look into status page as below.

http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status


Next week, we'll move forward to the next chapter "Configuring and
administering". Any comments are welcome. Anyone who wants to start writing
new feature or enhancement, please go ahead.

Jeff





Ted Kirby-2 wrote:
> 
> Thanks Sophia.  I consolidated some GEP installation pages to one page
> on the status page.
> 
> Ted Kirby
> 
> On Fri, Nov 21, 2008 at 2:34 AM, Ying Tang <[EMAIL PROTECTED]> wrote:
>>> Hi all,
>>>
>>>By the end of this week, we have almost finished refining the
>>> structure
>>> for Geronimo 2.2 documents, by dividing pages with multiple topics into
>>> separate pages, and moving pages to their appropriate parents. Meanwhile
>>> we
>>> are making incremental changes, importing information from the
>>> development
>>> documents.
>>>
>>>Any of your comments on the structure or topics are appreciated. We
>>> hope more people can chime in and write about your favorite new topics,
>>> for
>>> example, plugin profiles, and server cluster management.
>>>
>>>The documentation status is kept here:
>>>
>>> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status
>>
>>
>> Thanks and Regards,
>>
>> Ying Tang (Sophia)
>>
>>
> 
> 

-- 
View this message in context: 
http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20730864.html
Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com.

Re: Update on documentation progress of Geronimo v2.2

[Ted Kirby]

Thanks Sophia.  I consolidated some GEP installation pages to one page
on the status page.

Ted Kirby

On Fri, Nov 21, 2008 at 2:34 AM, Ying Tang <[EMAIL PROTECTED]> wrote:
>> Hi all,
>>
>>By the end of this week, we have almost finished refining the structure
>> for Geronimo 2.2 documents, by dividing pages with multiple topics into
>> separate pages, and moving pages to their appropriate parents. Meanwhile we
>> are making incremental changes, importing information from the development
>> documents.
>>
>>Any of your comments on the structure or topics are appreciated. We
>> hope more people can chime in and write about your favorite new topics, for
>> example, plugin profiles, and server cluster management.
>>
>>The documentation status is kept here:
>>
>> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status
>
>
> Thanks and Regards,
>
> Ying Tang (Sophia)
>
>

Re: Update on documentation progress of Geronimo v2.2

[Ying Tang]

>
> Hi all,
>
>By the end of this week, we have almost finished refining the structure
> for Geronimo 2.2 documents, by dividing pages with multiple topics into
> separate pages, and moving pages to their appropriate parents. Meanwhile we
> are making incremental changes, importing information from the development
> documents.
>
>Any of your comments on the structure or topics are appreciated. We hope
> more people can chime in and write about your favorite new topics, for
> example, plugin profiles, and server cluster management.
>
>The documentation status is kept here:
>
> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status



Thanks and Regards,

Ying Tang (Sophia)

Re: Update on documentation progress of Geronimo v2.2

[Ying Tang]

Ted, thanks a lot for helping out.

We have created separate child pages for "Development
environment"
topics, and we are working on the other part of the documentation in the
same way.

Just as you mentioned, the current document has lots of duplication and we
also share the same concern about putting much information on one page,
which makes documents hard to reuse and might result in huge workload to
keep consistency within the topics.

The core concept of Geronimo is to let developers focus on their killer app
and I think we can utilize the same concept on writing Geronimo docs.


Best Regards,

Ying Tang (Sophia)

Re: Update on documentation progress of Geronimo v2.2

[Ted Kirby]

I "fixed up" some of the references to GEP pages.  There is some
duplication of GEP info between two sets of pages:  "Development
environment" and "How to install Geronimo Eclipse Plugin".  A couple
of months ago I removed the installation instructions from the former,
and replaced them with a link to the latter.  The idea is to keep this
information in one place.  You can follow the gory details of this
work in GERONIMODEVTOOLS-461.  The plan is that there will be a "How
to install Geronimo Eclipse Plugin" page for each release.  Old and
new releases are children of this page.

The design of "Development environment" page seemed to be to put
everything on one big page.  I don't think this is a good approach.  I
think pages should be shorter and more focused.  For example, breaking
out the installation information.

Hopefully, we can all by in sync moving forward.  I think the GEP doc
needs some work in terms of integrating it into the overall G doc, and
eliminating duplication.  Hopefully this can occur in G 2.2 and
beyond.

Thanks,
Ted Kirby

On Fri, Nov 14, 2008 at 1:13 AM, chi runhua <[EMAIL PROTECTED]> wrote:
> Hi all,
>
> We just created a page with one table of content to track progress of
> Geronimo 2.2 documentation. In this table, we highlighted some topics to be
> updated based on G 2.2 release roadmap. We believe that not every topic was
> included so far. Therefore, don't hesitate updating the table if you have
> new discoveries or topics. We also encourage everyone in this community to
> adopt topics and contribute more to the success of Geronimo.
>
> Here is the linkage for your reference.
> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status
>
> What we are planning to do next are:
>
> 1. Moving pages to their appropriate parent so that the structure will be
> more like a "tree";  ---> Ongoing
> 2. Keep the consistency between different topics including subject, wording
> and phrases;
> 3. Keep migrating topics from previous documentation and update them if
> capable;
> 4. Refine the granuality by dividing unique topics into pages, in this way,
> contibutors can include existing pages while writing a new topics instead of
> introducing basic concepts again and again. (might be difficult, but I hope
> it's the right direction);
>
> We are expecting to receive as much as feedback and opinions about
> documentation so that we can make it better and better.
>
> Thanks alot.
>
>
>
>
>
>
>
>
>
>
>

Re: Update on documentation progress of Geronimo v2.2

[RunHua Chi]

Please use firefox to view the table. I just tried with IE, it turns out to
be an deadlock(keep refreshing the page).  Not sure about the reason yet. :(

Jeff


RunHua Chi wrote:
> 
> Hi all,
> 
> We just created a page with one table of content to track progress of
> Geronimo 2.2 documentation. In this table, we highlighted some topics to
> be
> updated based on G 2.2 release roadmap. We believe that not every topic
> was
> included so far. Therefore, don't hesitate updating the table if you have
> new discoveries or topics. We also encourage everyone in this community to
> adopt topics and contribute more to the success of Geronimo.
> 
> Here is the linkage for your reference.
> http://cwiki.apache.org/confluence/display/GMOxDOC22/Apache+Geronimo+v2.2+documentation+development+status
> 
> What we are planning to do next are:
> 
> 1. Moving pages to their appropriate parent so that the structure will be
> more like a "tree";  ---> Ongoing
> 2. Keep the consistency between different topics including subject,
> wording
> and phrases;
> 3. Keep migrating topics from previous documentation and update them if
> capable;
> 4. Refine the granuality by dividing unique topics into pages, in this
> way,
> contibutors can include existing pages while writing a new topics instead
> of
> introducing basic concepts again and again. (might be difficult, but I
> hope
> it's the right direction);
> 
> We are expecting to receive as much as feedback and opinions about
> documentation so that we can make it better and better.
> 
> Thanks alot.
> 
> 

-- 
View this message in context: 
http://www.nabble.com/Update-on-documentation-progress-of-Geronimo-v2.2-tp20495528s134p20496723.html
Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com.