You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@tuscany.apache.org by haleh mahbod <hm...@gmail.com> on 2008/04/09 21:26:05 UTC
Re: SCA 2.0, was Re: Next SCA release
>1 - [] Put V2 doc changes in V1 pages and mark them as such
>2 - [] Create SCA Java 1.x/ SCA Java 2.x documentation pages on our current
site wiki
>3 - [] Create separate SCA Java 1.x/ SCA Java 2.x wiki spaces
Option 2 seems reasonable. Option 3 can be considered in the future if
there is a need.
It would be good to get user's perspective on all this.
On 4/9/08, Simon Laws <si...@googlemail.com> wrote:
>
> On Wed, Apr 9, 2008 at 5:03 PM, ant elder <an...@gmail.com> wrote:
>
> > On Wed, Apr 9, 2008 at 4:56 PM, Simon Laws <si...@googlemail.com>
> > wrote:
> >
> > > On Wed, Apr 9, 2008 at 4:47 PM, haleh mahbod <hm...@gmail.com>
> wrote:
> > >
> > > > +1 on versioning SCA docs
> > > >
> > > > Assuming two versions of SCA Java, I can see that the following page
> > > will
> > > > change to point to two different versions of SCA Java, 1.x and 2.x
> and
> > > > their
> > > > related documentation.
> > > >
> > > >
> > >
> >
> http://incubator.apache.org/tuscany/tuscany-downloads-documentations.html
> > > >
> > > > Tuscany SCA Java general page would contain general information that
> > > would
> > > > pertain to both versions. So, it might need to change.
> > > > http://incubator.apache.org/tuscany/sca-java.html
> > > >
> > > > On the left navigation of sca-java page, we would have two boxes
> > > > SCA Java 2.x
> > > > SCA Java 1.x
> > > >
> > > > each would point to their own releases and their own documentations
> > and
> > > > source code tree.
> > > >
> > > > There is a set of documentations under SCA Java that are generic,
> like
> > > > development guide. We could share these pages between the two
> > versions.
> > > >
> > > > Does this make sense?
> > > >
> > > >
> > > Generally make sense to me.
> > >
> > > On the particular question of where to host V2 and V2 docs we have
> > > identified 3 choices so far.
> > >
> > > 1 - [] Put V2 doc changes in V1 pages and mark them as such
> > > 2 - [] Create SCA Java 1.x/ SCA Java 2.x documentation pages on our
> > > current
> > > site wiki
> > > 3 - [] Create separate SCA Java 1.x/ SCA Java 2.x wiki spaces
> > >
> > > Are there other cunning options we need to consider. I'm for option 2
> at
> > > the
> > > current time.
> > >
> > > Simon
> > >
> >
> > How would that option [2] actually work?
> >
> > Lets say I change the way the dwr binding works and want to update the
> doc
> > for V2, the current wiki page is at
> > http://incubator.apache.org/tuscany/sca-java-bindingajax.html so what
> > would
> > i do for the new v2 page?
> >
> > ...ant
>
>
> You would make
> http://incubator.apache.org/tuscany/sca-java-v2-bindingajax.html<
> http://incubator.apache.org/tuscany/sca-java-bindingajax.html>.
> Copy the existing contents there. Edit them which whatever change you need
> to make and and then add a link to this page to the V2 index (which I
> expect
> will, by default, link to the existing pages).
>
> Simon
>
Re: SCA 2.0, was Re: Next SCA release
Posted by Jean-Sebastien Delfino <js...@apache.org>.
haleh mahbod wrote:
>> 1 - [] Put V2 doc changes in V1 pages and mark them as such
>> 2 - [] Create SCA Java 1.x/ SCA Java 2.x documentation pages on our current
> site wiki
>> 3 - [] Create separate SCA Java 1.x/ SCA Java 2.x wiki spaces
>
> Option 2 seems reasonable. Option 3 can be considered in the future if
> there is a need.
> It would be good to get user's perspective on all this.
>
+0.5 for options [1], [2] and maybe [3] later :)
I'm just saying 0.5 as looking at our current docs as I'm not sure about
how people are planning to change them in 2.0. It's a little difficult
to discuss a process to manage changes without knowing the extent and
nature of the changes :)
--
Jean-Sebastien
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-user-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-user-help@ws.apache.org
Re: SCA 2.0, was Re: Next SCA release
Posted by Jean-Sebastien Delfino <js...@apache.org>.
haleh mahbod wrote:
>> 1 - [] Put V2 doc changes in V1 pages and mark them as such
>> 2 - [] Create SCA Java 1.x/ SCA Java 2.x documentation pages on our current
> site wiki
>> 3 - [] Create separate SCA Java 1.x/ SCA Java 2.x wiki spaces
>
> Option 2 seems reasonable. Option 3 can be considered in the future if
> there is a need.
> It would be good to get user's perspective on all this.
>
+0.5 for options [1], [2] and maybe [3] later :)
I'm just saying 0.5 as looking at our current docs as I'm not sure about
how people are planning to change them in 2.0. It's a little difficult
to discuss a process to manage changes without knowing the extent and
nature of the changes :)
--
Jean-Sebastien
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-dev-help@ws.apache.org