FW: Suggestions for Tuscany SCA documenation?

2007-03-02 Thread Antollini, Mario
E. Antollini Intel Software ASDC +54 351 414 5594 [EMAIL PROTECTED] -Original Message- From: Shelita Overton [mailto:[EMAIL PROTECTED] Sent: Friday, February 23, 2007 1:25 PM To: tuscany-dev@ws.apache.org Subject: Re: Suggestions for Tuscany SCA documenation? Based on the previous

Re: Suggestions for Tuscany SCA documenation?

2007-02-23 Thread Shelita Overton
Based on the previous discussions, I have created empty pages for a Developer Guide and an Extension Developer Guide, (User Guide has been already created). http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Documentation There was some current existing documents that were listed as

Re: Suggestions for Tuscany SCA documenation?

2007-02-23 Thread Jeremy Boynes
I found the layout here a little confusing, especially on the distinction between someone who want's to write an SCA application and test/run it on Tuscany and someone who is looking to start contributing to Tuscany itself. I'd suggest the following changes: * rename User Guide to Quick

Re: Suggestions for Tuscany SCA documenation?

2007-02-15 Thread haleh mahbod
Tom, Thanks for helping to move Tuscany website content to CWIKI. I like the the left navigation bar. We could use this opportunity to simplify the site and make it more user friendly. For example, we might want to re-think the way we handle languages and put some thought into how to highlight

Re: Suggestions for Tuscany SCA documenation?

2007-02-15 Thread Ole Ersoy
Hi, I'm working one some Maven plugins for automatically producing Eclipse Documentation Plugins that have an EMF (Could be pure documentation model) as a source. The first guide I will be automating the production of is this Apache Directory Contributor Guide:

Re: Suggestions for Tuscany SCA documenation?

2007-02-14 Thread Simon Laws
On 2/13/07, Jean-Sebastien Delfino [EMAIL PROTECTED] wrote: [snip] Tom Seelbach wrote: If the wiki was switched to a left menu theme it would probably apply to the whole space. That would not work well for Tuscany since it has 3 separate projects (sca, sdo, das) as well as 2 implementations

Re: Suggestions for Tuscany SCA documenation?

2007-02-14 Thread Dan Murphy
I like the idea of having a side navigator; a little concerned of the potential maintenance overhead of this on each wiki page that needs a navigator (although I guess it isn't needed on every page ?), but we'll only find out once we have a reasonable body of work, so I'll go with Simon's give it

Re: Suggestions for Tuscany SCA documenation?

2007-02-13 Thread Dan Murphy
Hi, In line with what Simon put above, it would seem sensible to try to prefix pages (as setting up extra spaces for a lowish number of pages does seem like an overhead) So... for SCA Java specific pages we prefix the page name with SCA Java Topic On 11/02/07, Simon Laws [EMAIL PROTECTED]

Re: Suggestions for Tuscany SCA documenation?

2007-02-13 Thread Dan Murphy
Sorry about that... finger trouble ! It seems that with the exception of the few obvious name clashes we can just go ahead and create pages. If later we discover a clash then we will need to change the page name accordingly. Assuming you use the normal wiki link markup cwiki fixes the link

Re: Suggestions for Tuscany SCA documenation?

2007-02-13 Thread Tom Seelbach
Dan Murphy wrote: Sorry about that... finger trouble ! It seems that with the exception of the few obvious name clashes we can just go ahead and create pages. If later we discover a clash then we will need to change the page name accordingly. Assuming you use the normal wiki link markup

Re: Suggestions for Tuscany SCA documenation?

2007-02-13 Thread Jean-Sebastien Delfino
[snip] Tom Seelbach wrote: If the wiki was switched to a left menu theme it would probably apply to the whole space. That would not work well for Tuscany since it has 3 separate projects (sca, sdo, das) as well as 2 implementations (java, cpp). i.e. the site is very complicated and it wouldn't

Re: Suggestions for Tuscany SCA documenation?

2007-02-11 Thread Simon Laws
On 2/10/07, haleh mahbod [EMAIL PROTECTED] wrote: Ah. You add a good point that we need to think about extension documents as well :) On 2/9/07, Jeremy Boynes [EMAIL PROTECTED] wrote: On Feb 9, 2007, at 4:56 PM, haleh mahbod wrote: Extension developer would generally not work off the

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread Dan Murphy
] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting point might be a user giude on how

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread Shelita Overton
- Original Message - From: haleh mahbod [EMAIL PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread Tom Seelbach
: haleh mahbod [EMAIL PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread haleh mahbod
mahbod [EMAIL PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread Jim Marino
A couple of minor points - Concept of attaching documents to releases is important here. Documents are not live and rather are based on releases. For example, we will have user manual for version x and an enhanced document for version y. Regardless of whether documentation is

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread haleh mahbod
Regardless of whether documentation is shipped in a distribution, I would prefer we keep a copy of all documentation online so that we can fix errors as they are discovered after releases. Agree. Extension developer would generally not work off the latest code (I generally discourage people

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread Jeremy Boynes
On Feb 9, 2007, at 4:56 PM, haleh mahbod wrote: Extension developer would generally not work off the latest code (I generally discourage people from doing this as the state of trunk may be in flux). They would tend to go off a published release. OK. Although it seems like all discussions are

Re: Suggestions for Tuscany SCA documenation?

2007-02-09 Thread haleh mahbod
Ah. You add a good point that we need to think about extension documents as well :) On 2/9/07, Jeremy Boynes [EMAIL PROTECTED] wrote: On Feb 9, 2007, at 4:56 PM, haleh mahbod wrote: Extension developer would generally not work off the latest code (I generally discourage people from doing

Re: Suggestions for Tuscany SCA documenation?

2007-02-08 Thread Simon Laws
a simple SCA application with Tuscany. Thanks, Raymond - Original Message - From: haleh mahbod [EMAIL PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly

Re: Suggestions for Tuscany SCA documenation?

2007-02-08 Thread Dan Murphy
@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting point might be a user giude on how to develop a simple SCA application. This document can

Re: Suggestions for Tuscany SCA documenation?

2007-02-08 Thread Shelita Overton
for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting point might be a user giude on how to develop a simple SCA application. This document can then incrementally grow to cover more advanced topics. Another project might

Re: Suggestions for Tuscany SCA documenation?

2007-02-08 Thread Simon Laws
PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting point might be a user giude on how to develop

Re: Suggestions for Tuscany SCA documenation?

2007-02-08 Thread Dan Murphy
@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting point might be a user giude on how to develop a simple SCA

Re: Suggestions for Tuscany SCA documenation?

2007-02-08 Thread Simon Laws
application with Tuscany. Thanks, Raymond - Original Message - From: haleh mahbod [EMAIL PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita

Suggestions for Tuscany SCA documenation?

2007-02-07 Thread Shelita Overton
Hi I would like to help with creating some documenation for Tuscany SCA... Does anyone have any suggestions on what should be covered first? Priority? Any content that could be used as a starting point? ~Shelita Overton

Re: Suggestions for Tuscany SCA documenation?

2007-02-07 Thread Rick Rineholt
Hello, If your totally new to SCA/Tuscany having a fresh pair of eyes looking at first understanding SCA, looking at our website how easy it is to find resources, how well those were, then moving on to the samples in M2 and then try and understand how contribute to Tuscany itself and along

Re: Suggestions for Tuscany SCA documenation?

2007-02-07 Thread haleh mahbod
Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting point might be a user giude on how to develop a simple SCA application. This document can then incrementally grow to cover more advanced topics. Another project might be to work on an SCA user doc with

Re: Suggestions for Tuscany SCA documenation?

2007-02-07 Thread Raymond Feng
@ws.apache.org Sent: Wednesday, February 07, 2007 10:19 AM Subject: Suggestions for Tuscany SCA documenation? Hi I would like to help with creating some documenation for Tuscany SCA... Does anyone have any suggestions on what should be covered first? Priority? Any content that could be used as a starting

Re: Suggestions for Tuscany SCA documenation?

2007-02-07 Thread Raymond Feng
, Raymond - Original Message - From: haleh mahbod [EMAIL PROTECTED] To: tuscany-dev@ws.apache.org Sent: Wednesday, February 07, 2007 11:33 AM Subject: Re: Suggestions for Tuscany SCA documenation? Hi Shelita, Welcome to Tuscany. We definitly need help with documentation :) A starting