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