>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 <[EMAIL PROTECTED]> wrote: > > On Wed, Apr 9, 2008 at 5:03 PM, ant elder <[EMAIL PROTECTED]> wrote: > > > On Wed, Apr 9, 2008 at 4:56 PM, Simon Laws <[EMAIL PROTECTED]> > > wrote: > > > > > On Wed, Apr 9, 2008 at 4:47 PM, haleh mahbod <[EMAIL PROTECTED]> > 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 >