Re: Geronimo Architecture Documentation

2006-12-17 Thread Ryan Senior
Hi Hernan, No problem on changing the names, I just did that. I have also added the {scrollbar} macro to it. I tried switching to the children macro and the only problem seems to be that the Introduction is listed after the diagrams and the GBeans section. Do I have the ability change the

Geronimo Architecture Documentation

2006-12-15 Thread Hernan Cunico
Hi Ryan, The Architecture doc is looking great, thanks for your contributions. I do have some "Confluence" related comments that will help with the entire Geronimo spaces integration. For example. http://cwiki.apache.org/confluence/display/GMOxDEV/Geronimo+Architecture In that page you are usi

Re: Geronimo Architecture Documentation

2006-09-29 Thread Jason Dillon
On Sep 29, 2006, at 7:22 AM, Matt Hogstrom wrote: I agree with the currency issue, however, at least they are a starting point and in general I think most people want to read a quick overview rather than check out an SVN tree (I said most, not all). Even if it became stale in a year it woul

Re: Geronimo Architecture Documentation

2006-09-29 Thread Matt Hogstrom
On Sep 28, 2006, at 5:07 AM, Jason Dillon wrote: Um... TeX or Docbook is probably much more "universal" in the open source world than any bloated, expensive and buggy microsoft unstableware. Hehehe...I'm not sure which is more fun, sending an e-mail with a reference to Microsoft and wai

Re: Geronimo Architecture Documentation

2006-09-28 Thread Hernan Cunico
Hi Ryan, That's great and I think the cwiki is the right place to host it. 20+ pages is not a lot for a section as long as we keep it well organized ;-) If you want to I can give you some advise on how to structure things in Confluence. Using other "format" than cwiki will divide the documentat

Re: Geronimo Architecture Documentation

2006-09-28 Thread Jason Dillon
Um... TeX or Docbook is probably much more "universal" in the open source world than any bloated, expensive and buggy microsoft unstableware. And, while I think architecture docs are great... they tend to become outdated very quickly, especially as we keep changing the internals of the se

Re: Geronimo Architecture Documentation

2006-09-27 Thread Matt Hogstrom
Well...Word format and Powerpoint as root formats is probably the most universal (Matt ducks anticipating a wave of anti-microsoft tomatoes) that are ultimately available as PDFs from the project. OpenOffice sounds nice but in my experience its not very good and less portable. On Sep 27,

Re: Geronimo Architecture Documentation

2006-09-27 Thread Andrus Adamchik
I don't see a problem with 20+ pages on Wiki. Geronimo and a number of other projects maintain their main doc sets via Confluence and it scales pretty well. Andrus On Sep 27, 2006, at 8:40 PM, Ryan Senior wrote: Hi all, I'd like to write some in-depth architecture documentation for Gero

Geronimo Architecture Documentation

2006-09-27 Thread Ryan Senior
Hi all, I'd like to write some in-depth architecture documentation for Geronimo. I'm thinking it might be a little large for the wiki (maybe 20 pages or more???). Is there a preferred documentation format? Maybe docbook? Is there a particular part of the architecture that I should make su