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
