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
