You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@stratos.apache.org by Imesh Gunaratne <im...@apache.org> on 2013/12/02 06:29:22 UTC

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

I think we could create a new Root Node called "Documentation" and move
"Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
each version. WDYT?

Sample:

- Documentation
    - 3.0.0-incubating
        - Getting Started
        - User Guide
        - Developer Guide
        - Testing Procedure
    - 4.0.0-incubating
        - Getting Started
        - User Guide
        - Developer Guide
        - Testing Procedure


Appreciate your feedback.

Thanks
Imesh



On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org> wrote:

> Hi All,
>
> Currently Apache Stratos (incubating) Wiki navigation structure looks like
> below:
>
> [image: Inline image 3]
>
> May be we could improve it by grouping the versions under a element called
> "Documentation". Something similar to Axis2 Wiki:
>
> [image: Inline image 4]
>
> What do you think?
>
> Thanks
> Imesh
>

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Imesh Gunaratne <im...@apache.org>.
A good suggestion Mari!
+1 for 2


On Tue, Dec 3, 2013 at 5:32 PM, Udara Liyanage <ud...@wso2.com> wrote:

> me for 2
>
>
> On Tue, Dec 3, 2013 at 6:54 AM, Lakmal Warusawithana <la...@wso2.com>wrote:
>
>>
>>
>>
>> On Tue, Dec 3, 2013 at 5:00 PM, Mariangela Hills <ma...@wso2.com>wrote:
>>
>>> The wiki is powered by Confluence. In Confluence each page name needs to
>>> be unique. Therefore, we can not have two pages with the same name.
>>>
>>> How about we use one of the following structures for the manuals. The
>>> following structures are based on a hypothetical scenario, taking into
>>> account that we have released 4.0.0 and we are working on the docs of a new
>>> release (e.g., 5.0.0) which has not been released yet.
>>> (1)
>>> - Documentation
>>>     - 4.0.0-incubating
>>>         - 4.0.0 Getting Started
>>>         - 4.0.0 User Guide
>>>         - 4.0.0 Developer Guide
>>>         - 4.0.0 Testing Procedure
>>>     - 3.0.0-incubating
>>>         - 3.0.0 Getting Started
>>>         - 3.0.0 User Guide
>>>         - 3.0.0 Developer Guide
>>>         - 3.0.0 Testing Procedure
>>>   - Future Release
>>>     - 5.0.0-incubating
>>>         - 5.0.0 Getting Started
>>>         - 5.0.0 User Guide
>>>         - 5.0.0 Developer Guide
>>>         - 5.0.0 Testing Procedure
>>>
>>> (2)
>>> - Documentation
>>>   - 4.0.0-incubating
>>>         - 4.0.0 Getting Started
>>>         - 4.0.0 User Guide
>>>         - 4.0.0 Developer Guide
>>>         - 4.0.0 Testing Procedure
>>>  - Archives
>>>     - 3.0.0-incubating
>>>         - 3.0.0 Getting Started
>>>         - 3.0.0 User Guide
>>>         - 3.0.0 Developer Guide
>>>         - 3.0.0 Testing Procedure
>>>  - Future Release
>>>     - 5.0.0-incubating
>>>         - 5.0.0 Getting Started
>>>         - 5.0.0 User Guide
>>>         - 5.0.0 Developer Guide
>>>         - 5.0.0 Testing Procedure
>>>
>>> Please let me know which structure is more suitable or whether you have
>>> a better idea.
>>> I vote for 2
>>>
>>
>> +1 for 2
>>
>>>
>>> Regards,
>>> Mariangela
>>>
>>>
>>>
>>> *--Mariangela Hills*
>>> Senior Technical Writer
>>> Mobile:(+94)773500185
>>>
>>> WSO2 Inc. http://wso2.com/
>>>
>>>
>>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>
>>>> I think we could create a new Root Node called "Documentation" and move
>>>> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
>>>> each version. WDYT?
>>>>
>>>> Sample:
>>>>
>>>> - Documentation
>>>>     - 3.0.0-incubating
>>>>         - Getting Started
>>>>         - User Guide
>>>>         - Developer Guide
>>>>         - Testing Procedure
>>>>     - 4.0.0-incubating
>>>>         - Getting Started
>>>>         - User Guide
>>>>         - Developer Guide
>>>>         - Testing Procedure
>>>>
>>>>
>>>> Appreciate your feedback.
>>>>
>>>> Thanks
>>>> Imesh
>>>>
>>>>
>>>>
>>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>
>>>>> Hi All,
>>>>>
>>>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>>>> like below:
>>>>>
>>>>> [image: Inline image 3]
>>>>>
>>>>> May be we could improve it by grouping the versions under a element
>>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>>
>>>>> [image: Inline image 4]
>>>>>
>>>>> What do you think?
>>>>>
>>>>> Thanks
>>>>> Imesh
>>>>>
>>>>
>>>>
>>>
>>
>>
>> --
>> Lakmal Warusawithana
>> Software Architect; WSO2 Inc.
>> Mobile : +94714289692
>> Blog : http://lakmalsview.blogspot.com/
>>
>>
>
>
> --
> Udara Liyanage
> Software Engineer
> WSO2, Inc.: http://wso2.com
> lean. enterprise. middleware
>
> web: http://udaraliyanage.wordpress.com
> phone: +94 71 443 6897
>

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Udara Liyanage <ud...@wso2.com>.
me for 2


On Tue, Dec 3, 2013 at 6:54 AM, Lakmal Warusawithana <la...@wso2.com>wrote:

>
>
>
> On Tue, Dec 3, 2013 at 5:00 PM, Mariangela Hills <ma...@wso2.com>wrote:
>
>> The wiki is powered by Confluence. In Confluence each page name needs to
>> be unique. Therefore, we can not have two pages with the same name.
>>
>> How about we use one of the following structures for the manuals. The
>> following structures are based on a hypothetical scenario, taking into
>> account that we have released 4.0.0 and we are working on the docs of a new
>> release (e.g., 5.0.0) which has not been released yet.
>> (1)
>> - Documentation
>>     - 4.0.0-incubating
>>         - 4.0.0 Getting Started
>>         - 4.0.0 User Guide
>>         - 4.0.0 Developer Guide
>>         - 4.0.0 Testing Procedure
>>     - 3.0.0-incubating
>>         - 3.0.0 Getting Started
>>         - 3.0.0 User Guide
>>         - 3.0.0 Developer Guide
>>         - 3.0.0 Testing Procedure
>>   - Future Release
>>     - 5.0.0-incubating
>>         - 5.0.0 Getting Started
>>         - 5.0.0 User Guide
>>         - 5.0.0 Developer Guide
>>         - 5.0.0 Testing Procedure
>>
>> (2)
>> - Documentation
>>   - 4.0.0-incubating
>>         - 4.0.0 Getting Started
>>         - 4.0.0 User Guide
>>         - 4.0.0 Developer Guide
>>         - 4.0.0 Testing Procedure
>>  - Archives
>>     - 3.0.0-incubating
>>         - 3.0.0 Getting Started
>>         - 3.0.0 User Guide
>>         - 3.0.0 Developer Guide
>>         - 3.0.0 Testing Procedure
>>  - Future Release
>>     - 5.0.0-incubating
>>         - 5.0.0 Getting Started
>>         - 5.0.0 User Guide
>>         - 5.0.0 Developer Guide
>>         - 5.0.0 Testing Procedure
>>
>> Please let me know which structure is more suitable or whether you have a
>> better idea.
>> I vote for 2
>>
>
> +1 for 2
>
>>
>> Regards,
>> Mariangela
>>
>>
>>
>> *--Mariangela Hills*
>> Senior Technical Writer
>> Mobile:(+94)773500185
>>
>> WSO2 Inc. http://wso2.com/
>>
>>
>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>
>>> I think we could create a new Root Node called "Documentation" and move
>>> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
>>> each version. WDYT?
>>>
>>> Sample:
>>>
>>> - Documentation
>>>     - 3.0.0-incubating
>>>         - Getting Started
>>>         - User Guide
>>>         - Developer Guide
>>>         - Testing Procedure
>>>     - 4.0.0-incubating
>>>         - Getting Started
>>>         - User Guide
>>>         - Developer Guide
>>>         - Testing Procedure
>>>
>>>
>>> Appreciate your feedback.
>>>
>>> Thanks
>>> Imesh
>>>
>>>
>>>
>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>
>>>> Hi All,
>>>>
>>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>>> like below:
>>>>
>>>> [image: Inline image 3]
>>>>
>>>> May be we could improve it by grouping the versions under a element
>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>
>>>> [image: Inline image 4]
>>>>
>>>> What do you think?
>>>>
>>>> Thanks
>>>> Imesh
>>>>
>>>
>>>
>>
>
>
> --
> Lakmal Warusawithana
> Software Architect; WSO2 Inc.
> Mobile : +94714289692
> Blog : http://lakmalsview.blogspot.com/
>
>


-- 
Udara Liyanage
Software Engineer
WSO2, Inc.: http://wso2.com
lean. enterprise. middleware

web: http://udaraliyanage.wordpress.com
phone: +94 71 443 6897

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Lakmal Warusawithana <la...@wso2.com>.
On Tue, Dec 3, 2013 at 5:00 PM, Mariangela Hills <ma...@wso2.com>wrote:

> The wiki is powered by Confluence. In Confluence each page name needs to
> be unique. Therefore, we can not have two pages with the same name.
>
> How about we use one of the following structures for the manuals. The
> following structures are based on a hypothetical scenario, taking into
> account that we have released 4.0.0 and we are working on the docs of a new
> release (e.g., 5.0.0) which has not been released yet.
> (1)
> - Documentation
>     - 4.0.0-incubating
>         - 4.0.0 Getting Started
>         - 4.0.0 User Guide
>         - 4.0.0 Developer Guide
>         - 4.0.0 Testing Procedure
>     - 3.0.0-incubating
>         - 3.0.0 Getting Started
>         - 3.0.0 User Guide
>         - 3.0.0 Developer Guide
>         - 3.0.0 Testing Procedure
>   - Future Release
>     - 5.0.0-incubating
>         - 5.0.0 Getting Started
>         - 5.0.0 User Guide
>         - 5.0.0 Developer Guide
>         - 5.0.0 Testing Procedure
>
> (2)
> - Documentation
>   - 4.0.0-incubating
>         - 4.0.0 Getting Started
>         - 4.0.0 User Guide
>         - 4.0.0 Developer Guide
>         - 4.0.0 Testing Procedure
>  - Archives
>     - 3.0.0-incubating
>         - 3.0.0 Getting Started
>         - 3.0.0 User Guide
>         - 3.0.0 Developer Guide
>         - 3.0.0 Testing Procedure
>  - Future Release
>     - 5.0.0-incubating
>         - 5.0.0 Getting Started
>         - 5.0.0 User Guide
>         - 5.0.0 Developer Guide
>         - 5.0.0 Testing Procedure
>
> Please let me know which structure is more suitable or whether you have a
> better idea.
> I vote for 2
>

+1 for 2

>
> Regards,
> Mariangela
>
>
>
> *--Mariangela Hills*
> Senior Technical Writer
> Mobile:(+94)773500185
>
> WSO2 Inc. http://wso2.com/
>
>
> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org> wrote:
>
>> I think we could create a new Root Node called "Documentation" and move
>> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
>> each version. WDYT?
>>
>> Sample:
>>
>> - Documentation
>>     - 3.0.0-incubating
>>         - Getting Started
>>         - User Guide
>>         - Developer Guide
>>         - Testing Procedure
>>     - 4.0.0-incubating
>>         - Getting Started
>>         - User Guide
>>         - Developer Guide
>>         - Testing Procedure
>>
>>
>> Appreciate your feedback.
>>
>> Thanks
>> Imesh
>>
>>
>>
>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>
>>> Hi All,
>>>
>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>> like below:
>>>
>>> [image: Inline image 3]
>>>
>>> May be we could improve it by grouping the versions under a element
>>> called "Documentation". Something similar to Axis2 Wiki:
>>>
>>> [image: Inline image 4]
>>>
>>> What do you think?
>>>
>>> Thanks
>>> Imesh
>>>
>>
>>
>


-- 
Lakmal Warusawithana
Software Architect; WSO2 Inc.
Mobile : +94714289692
Blog : http://lakmalsview.blogspot.com/

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Nirmal Fernando <ni...@gmail.com>.
On Wed, Dec 4, 2013 at 10:58 AM, Isuru Perera <is...@wso2.com> wrote:

>
> Hi,
>
> On Tue, Dec 3, 2013 at 9:01 PM, Nirmal Fernando <ni...@gmail.com>wrote:
>
>>
>>
>>
>> On Wed, Dec 4, 2013 at 9:51 AM, Isuru Perera <is...@wso2.com> wrote:
>>
>>> I said we would *recommend* to use latest version.. and we will keep
>>> important stuff for previous versions..
>>>
>>
>> Where would you suggest to keep these?
>>
> Getting Started, Developer Guide etc pages can have latest info. And add
> notes if it is different for a previous versions.
>

It will clutter the pages unnecessarily IMO. It is ok to add notes in minor
versions, but in major releases, it would not make sense.

What do you think?

>
> Installation Guide etc pages can have a separate page for older versions..
> A generic page for latest version for example "Installation Guide" and a
> separate page for an older version for example "Installation Guide - 3.0.0
> incubating".
>
> Please avoid restructuring whole wiki if possible
>
> I'm just -0 on this.
>
> Thanks!
>
>>  No need to restructure whole wiki!
>>>
>>>
>>> On Tue, Dec 3, 2013 at 7:31 PM, Nirmal Fernando <ni...@gmail.com>wrote:
>>>
>>>> Oh... you can't always ask people to switch to the latest version :)
>>>> Impractical IMO.
>>>>
>>>>
>>>> On Wed, Dec 4, 2013 at 8:06 AM, Isuru Perera <is...@wso2.com> wrote:
>>>>
>>>>> Do we really need to maintain docs for previous versions? Since we
>>>>> will be releasing versions in short durations, I don't think it's a good
>>>>> idea to restructure wiki like this. We will also be recommending to use
>>>>> latest version. We can have the significant info for each version in same
>>>>> pages.
>>>>>
>>>>> This is just my personal opinion.
>>>>>
>>>>>
>>>>> On Tue, Dec 3, 2013 at 3:30 AM, Mariangela Hills <ma...@wso2.com>wrote:
>>>>>
>>>>>> The wiki is powered by Confluence. In Confluence each page name needs
>>>>>> to be unique. Therefore, we can not have two pages with the same name.
>>>>>>
>>>>>> How about we use one of the following structures for the manuals. The
>>>>>> following structures are based on a hypothetical scenario, taking into
>>>>>> account that we have released 4.0.0 and we are working on the docs of a new
>>>>>> release (e.g., 5.0.0) which has not been released yet.
>>>>>> (1)
>>>>>> - Documentation
>>>>>>     - 4.0.0-incubating
>>>>>>         - 4.0.0 Getting Started
>>>>>>         - 4.0.0 User Guide
>>>>>>         - 4.0.0 Developer Guide
>>>>>>         - 4.0.0 Testing Procedure
>>>>>>     - 3.0.0-incubating
>>>>>>         - 3.0.0 Getting Started
>>>>>>         - 3.0.0 User Guide
>>>>>>         - 3.0.0 Developer Guide
>>>>>>         - 3.0.0 Testing Procedure
>>>>>>   - Future Release
>>>>>>     - 5.0.0-incubating
>>>>>>         - 5.0.0 Getting Started
>>>>>>         - 5.0.0 User Guide
>>>>>>         - 5.0.0 Developer Guide
>>>>>>         - 5.0.0 Testing Procedure
>>>>>>
>>>>>> (2)
>>>>>> - Documentation
>>>>>>   - 4.0.0-incubating
>>>>>>         - 4.0.0 Getting Started
>>>>>>         - 4.0.0 User Guide
>>>>>>         - 4.0.0 Developer Guide
>>>>>>         - 4.0.0 Testing Procedure
>>>>>>  - Archives
>>>>>>     - 3.0.0-incubating
>>>>>>         - 3.0.0 Getting Started
>>>>>>         - 3.0.0 User Guide
>>>>>>         - 3.0.0 Developer Guide
>>>>>>         - 3.0.0 Testing Procedure
>>>>>>  - Future Release
>>>>>>     - 5.0.0-incubating
>>>>>>         - 5.0.0 Getting Started
>>>>>>         - 5.0.0 User Guide
>>>>>>         - 5.0.0 Developer Guide
>>>>>>         - 5.0.0 Testing Procedure
>>>>>>
>>>>>> Please let me know which structure is more suitable or whether you
>>>>>> have a better idea.
>>>>>> I vote for 2
>>>>>>
>>>>>> Regards,
>>>>>> Mariangela
>>>>>>
>>>>>>
>>>>>>
>>>>>> *--Mariangela Hills*
>>>>>> Senior Technical Writer
>>>>>> Mobile:(+94)773500185
>>>>>>
>>>>>> WSO2 Inc. http://wso2.com/
>>>>>>
>>>>>>
>>>>>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>>>
>>>>>>> I think we could create a new Root Node called "Documentation" and
>>>>>>> move "Getting Started", "User Guide", "Developer Guide", "Testing
>>>>>>> Procedure" to each version. WDYT?
>>>>>>>
>>>>>>> Sample:
>>>>>>>
>>>>>>> - Documentation
>>>>>>>     - 3.0.0-incubating
>>>>>>>         - Getting Started
>>>>>>>         - User Guide
>>>>>>>         - Developer Guide
>>>>>>>         - Testing Procedure
>>>>>>>     - 4.0.0-incubating
>>>>>>>         - Getting Started
>>>>>>>         - User Guide
>>>>>>>         - Developer Guide
>>>>>>>         - Testing Procedure
>>>>>>>
>>>>>>>
>>>>>>> Appreciate your feedback.
>>>>>>>
>>>>>>> Thanks
>>>>>>> Imesh
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>>>>
>>>>>>>> Hi All,
>>>>>>>>
>>>>>>>> Currently Apache Stratos (incubating) Wiki navigation structure
>>>>>>>> looks like below:
>>>>>>>>
>>>>>>>> [image: Inline image 3]
>>>>>>>>
>>>>>>>> May be we could improve it by grouping the versions under a element
>>>>>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>>>>>
>>>>>>>> [image: Inline image 4]
>>>>>>>>
>>>>>>>> What do you think?
>>>>>>>>
>>>>>>>> Thanks
>>>>>>>> Imesh
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> Isuru Perera
>>>>> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
>>>>> Lean . Enterprise . Middleware
>>>>>
>>>>> about.me/chrishantha
>>>>>
>>>>
>>>>
>>>>
>>>> --
>>>> Best Regards,
>>>> Nirmal
>>>>
>>>> Nirmal Fernando.
>>>> PPMC Member & Committer of Apache Stratos,
>>>> Senior Software Engineer, WSO2 Inc.
>>>>
>>>> Blog: http://nirmalfdo.blogspot.com/
>>>>
>>>
>>>
>>>
>>> --
>>> Isuru Perera
>>> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
>>> Lean . Enterprise . Middleware
>>>
>>> about.me/chrishantha
>>>
>>
>>
>>
>> --
>> Best Regards,
>> Nirmal
>>
>> Nirmal Fernando.
>> PPMC Member & Committer of Apache Stratos,
>> Senior Software Engineer, WSO2 Inc.
>>
>> Blog: http://nirmalfdo.blogspot.com/
>>
>
>
>
> --
> Isuru Perera
> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
> Lean . Enterprise . Middleware
>
> about.me/chrishantha
>



-- 
Best Regards,
Nirmal

Nirmal Fernando.
PPMC Member & Committer of Apache Stratos,
Senior Software Engineer, WSO2 Inc.

Blog: http://nirmalfdo.blogspot.com/

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Isuru Perera <is...@wso2.com>.
Hi,

On Tue, Dec 3, 2013 at 9:01 PM, Nirmal Fernando <ni...@gmail.com>wrote:

>
>
>
> On Wed, Dec 4, 2013 at 9:51 AM, Isuru Perera <is...@wso2.com> wrote:
>
>> I said we would *recommend* to use latest version.. and we will keep
>> important stuff for previous versions..
>>
>
> Where would you suggest to keep these?
>
Getting Started, Developer Guide etc pages can have latest info. And add
notes if it is different for a previous versions.

Installation Guide etc pages can have a separate page for older versions..
A generic page for latest version for example "Installation Guide" and a
separate page for an older version for example "Installation Guide - 3.0.0
incubating".

Please avoid restructuring whole wiki if possible

I'm just -0 on this.

Thanks!

>  No need to restructure whole wiki!
>>
>>
>> On Tue, Dec 3, 2013 at 7:31 PM, Nirmal Fernando <ni...@gmail.com>wrote:
>>
>>> Oh... you can't always ask people to switch to the latest version :)
>>> Impractical IMO.
>>>
>>>
>>> On Wed, Dec 4, 2013 at 8:06 AM, Isuru Perera <is...@wso2.com> wrote:
>>>
>>>> Do we really need to maintain docs for previous versions? Since we will
>>>> be releasing versions in short durations, I don't think it's a good idea to
>>>> restructure wiki like this. We will also be recommending to use latest
>>>> version. We can have the significant info for each version in same pages.
>>>>
>>>> This is just my personal opinion.
>>>>
>>>>
>>>> On Tue, Dec 3, 2013 at 3:30 AM, Mariangela Hills <ma...@wso2.com>wrote:
>>>>
>>>>> The wiki is powered by Confluence. In Confluence each page name needs
>>>>> to be unique. Therefore, we can not have two pages with the same name.
>>>>>
>>>>> How about we use one of the following structures for the manuals. The
>>>>> following structures are based on a hypothetical scenario, taking into
>>>>> account that we have released 4.0.0 and we are working on the docs of a new
>>>>> release (e.g., 5.0.0) which has not been released yet.
>>>>> (1)
>>>>> - Documentation
>>>>>     - 4.0.0-incubating
>>>>>         - 4.0.0 Getting Started
>>>>>         - 4.0.0 User Guide
>>>>>         - 4.0.0 Developer Guide
>>>>>         - 4.0.0 Testing Procedure
>>>>>     - 3.0.0-incubating
>>>>>         - 3.0.0 Getting Started
>>>>>         - 3.0.0 User Guide
>>>>>         - 3.0.0 Developer Guide
>>>>>         - 3.0.0 Testing Procedure
>>>>>   - Future Release
>>>>>     - 5.0.0-incubating
>>>>>         - 5.0.0 Getting Started
>>>>>         - 5.0.0 User Guide
>>>>>         - 5.0.0 Developer Guide
>>>>>         - 5.0.0 Testing Procedure
>>>>>
>>>>> (2)
>>>>> - Documentation
>>>>>   - 4.0.0-incubating
>>>>>         - 4.0.0 Getting Started
>>>>>         - 4.0.0 User Guide
>>>>>         - 4.0.0 Developer Guide
>>>>>         - 4.0.0 Testing Procedure
>>>>>  - Archives
>>>>>     - 3.0.0-incubating
>>>>>         - 3.0.0 Getting Started
>>>>>         - 3.0.0 User Guide
>>>>>         - 3.0.0 Developer Guide
>>>>>         - 3.0.0 Testing Procedure
>>>>>  - Future Release
>>>>>     - 5.0.0-incubating
>>>>>         - 5.0.0 Getting Started
>>>>>         - 5.0.0 User Guide
>>>>>         - 5.0.0 Developer Guide
>>>>>         - 5.0.0 Testing Procedure
>>>>>
>>>>> Please let me know which structure is more suitable or whether you
>>>>> have a better idea.
>>>>> I vote for 2
>>>>>
>>>>> Regards,
>>>>> Mariangela
>>>>>
>>>>>
>>>>>
>>>>> *--Mariangela Hills*
>>>>> Senior Technical Writer
>>>>> Mobile:(+94)773500185
>>>>>
>>>>> WSO2 Inc. http://wso2.com/
>>>>>
>>>>>
>>>>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>>
>>>>>> I think we could create a new Root Node called "Documentation" and
>>>>>> move "Getting Started", "User Guide", "Developer Guide", "Testing
>>>>>> Procedure" to each version. WDYT?
>>>>>>
>>>>>> Sample:
>>>>>>
>>>>>> - Documentation
>>>>>>     - 3.0.0-incubating
>>>>>>         - Getting Started
>>>>>>         - User Guide
>>>>>>         - Developer Guide
>>>>>>         - Testing Procedure
>>>>>>     - 4.0.0-incubating
>>>>>>         - Getting Started
>>>>>>         - User Guide
>>>>>>         - Developer Guide
>>>>>>         - Testing Procedure
>>>>>>
>>>>>>
>>>>>> Appreciate your feedback.
>>>>>>
>>>>>> Thanks
>>>>>> Imesh
>>>>>>
>>>>>>
>>>>>>
>>>>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>>>
>>>>>>> Hi All,
>>>>>>>
>>>>>>> Currently Apache Stratos (incubating) Wiki navigation structure
>>>>>>> looks like below:
>>>>>>>
>>>>>>> [image: Inline image 3]
>>>>>>>
>>>>>>> May be we could improve it by grouping the versions under a element
>>>>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>>>>
>>>>>>> [image: Inline image 4]
>>>>>>>
>>>>>>> What do you think?
>>>>>>>
>>>>>>> Thanks
>>>>>>> Imesh
>>>>>>>
>>>>>>
>>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> Isuru Perera
>>>> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
>>>> Lean . Enterprise . Middleware
>>>>
>>>> about.me/chrishantha
>>>>
>>>
>>>
>>>
>>> --
>>> Best Regards,
>>> Nirmal
>>>
>>> Nirmal Fernando.
>>> PPMC Member & Committer of Apache Stratos,
>>> Senior Software Engineer, WSO2 Inc.
>>>
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>
>>
>>
>> --
>> Isuru Perera
>> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
>> Lean . Enterprise . Middleware
>>
>> about.me/chrishantha
>>
>
>
>
> --
> Best Regards,
> Nirmal
>
> Nirmal Fernando.
> PPMC Member & Committer of Apache Stratos,
> Senior Software Engineer, WSO2 Inc.
>
> Blog: http://nirmalfdo.blogspot.com/
>



-- 
Isuru Perera
Senior Software Engineer | WSO2, Inc. | http://wso2.com/
Lean . Enterprise . Middleware

about.me/chrishantha

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Nirmal Fernando <ni...@gmail.com>.
On Wed, Dec 4, 2013 at 9:51 AM, Isuru Perera <is...@wso2.com> wrote:

> I said we would *recommend* to use latest version.. and we will keep
> important stuff for previous versions..
>

Where would you suggest to keep these?

> No need to restructure whole wiki!
>
>
> On Tue, Dec 3, 2013 at 7:31 PM, Nirmal Fernando <ni...@gmail.com>wrote:
>
>> Oh... you can't always ask people to switch to the latest version :)
>> Impractical IMO.
>>
>>
>> On Wed, Dec 4, 2013 at 8:06 AM, Isuru Perera <is...@wso2.com> wrote:
>>
>>> Do we really need to maintain docs for previous versions? Since we will
>>> be releasing versions in short durations, I don't think it's a good idea to
>>> restructure wiki like this. We will also be recommending to use latest
>>> version. We can have the significant info for each version in same pages.
>>>
>>> This is just my personal opinion.
>>>
>>>
>>> On Tue, Dec 3, 2013 at 3:30 AM, Mariangela Hills <ma...@wso2.com>wrote:
>>>
>>>> The wiki is powered by Confluence. In Confluence each page name needs
>>>> to be unique. Therefore, we can not have two pages with the same name.
>>>>
>>>> How about we use one of the following structures for the manuals. The
>>>> following structures are based on a hypothetical scenario, taking into
>>>> account that we have released 4.0.0 and we are working on the docs of a new
>>>> release (e.g., 5.0.0) which has not been released yet.
>>>> (1)
>>>> - Documentation
>>>>     - 4.0.0-incubating
>>>>         - 4.0.0 Getting Started
>>>>         - 4.0.0 User Guide
>>>>         - 4.0.0 Developer Guide
>>>>         - 4.0.0 Testing Procedure
>>>>     - 3.0.0-incubating
>>>>         - 3.0.0 Getting Started
>>>>         - 3.0.0 User Guide
>>>>         - 3.0.0 Developer Guide
>>>>         - 3.0.0 Testing Procedure
>>>>   - Future Release
>>>>     - 5.0.0-incubating
>>>>         - 5.0.0 Getting Started
>>>>         - 5.0.0 User Guide
>>>>         - 5.0.0 Developer Guide
>>>>         - 5.0.0 Testing Procedure
>>>>
>>>> (2)
>>>> - Documentation
>>>>   - 4.0.0-incubating
>>>>         - 4.0.0 Getting Started
>>>>         - 4.0.0 User Guide
>>>>         - 4.0.0 Developer Guide
>>>>         - 4.0.0 Testing Procedure
>>>>  - Archives
>>>>     - 3.0.0-incubating
>>>>         - 3.0.0 Getting Started
>>>>         - 3.0.0 User Guide
>>>>         - 3.0.0 Developer Guide
>>>>         - 3.0.0 Testing Procedure
>>>>  - Future Release
>>>>     - 5.0.0-incubating
>>>>         - 5.0.0 Getting Started
>>>>         - 5.0.0 User Guide
>>>>         - 5.0.0 Developer Guide
>>>>         - 5.0.0 Testing Procedure
>>>>
>>>> Please let me know which structure is more suitable or whether you have
>>>> a better idea.
>>>> I vote for 2
>>>>
>>>> Regards,
>>>> Mariangela
>>>>
>>>>
>>>>
>>>> *--Mariangela Hills*
>>>> Senior Technical Writer
>>>> Mobile:(+94)773500185
>>>>
>>>> WSO2 Inc. http://wso2.com/
>>>>
>>>>
>>>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>
>>>>> I think we could create a new Root Node called "Documentation" and
>>>>> move "Getting Started", "User Guide", "Developer Guide", "Testing
>>>>> Procedure" to each version. WDYT?
>>>>>
>>>>> Sample:
>>>>>
>>>>> - Documentation
>>>>>     - 3.0.0-incubating
>>>>>         - Getting Started
>>>>>         - User Guide
>>>>>         - Developer Guide
>>>>>         - Testing Procedure
>>>>>     - 4.0.0-incubating
>>>>>         - Getting Started
>>>>>         - User Guide
>>>>>         - Developer Guide
>>>>>         - Testing Procedure
>>>>>
>>>>>
>>>>> Appreciate your feedback.
>>>>>
>>>>> Thanks
>>>>> Imesh
>>>>>
>>>>>
>>>>>
>>>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>>
>>>>>> Hi All,
>>>>>>
>>>>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>>>>> like below:
>>>>>>
>>>>>> [image: Inline image 3]
>>>>>>
>>>>>> May be we could improve it by grouping the versions under a element
>>>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>>>
>>>>>> [image: Inline image 4]
>>>>>>
>>>>>> What do you think?
>>>>>>
>>>>>> Thanks
>>>>>> Imesh
>>>>>>
>>>>>
>>>>>
>>>>
>>>
>>>
>>> --
>>> Isuru Perera
>>> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
>>> Lean . Enterprise . Middleware
>>>
>>> about.me/chrishantha
>>>
>>
>>
>>
>> --
>> Best Regards,
>> Nirmal
>>
>> Nirmal Fernando.
>> PPMC Member & Committer of Apache Stratos,
>> Senior Software Engineer, WSO2 Inc.
>>
>> Blog: http://nirmalfdo.blogspot.com/
>>
>
>
>
> --
> Isuru Perera
> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
> Lean . Enterprise . Middleware
>
> about.me/chrishantha
>



-- 
Best Regards,
Nirmal

Nirmal Fernando.
PPMC Member & Committer of Apache Stratos,
Senior Software Engineer, WSO2 Inc.

Blog: http://nirmalfdo.blogspot.com/

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Isuru Perera <is...@wso2.com>.
I said we would *recommend* to use latest version.. and we will keep
important stuff for previous versions.. No need to restructure whole wiki!


On Tue, Dec 3, 2013 at 7:31 PM, Nirmal Fernando <ni...@gmail.com>wrote:

> Oh... you can't always ask people to switch to the latest version :)
> Impractical IMO.
>
>
> On Wed, Dec 4, 2013 at 8:06 AM, Isuru Perera <is...@wso2.com> wrote:
>
>> Do we really need to maintain docs for previous versions? Since we will
>> be releasing versions in short durations, I don't think it's a good idea to
>> restructure wiki like this. We will also be recommending to use latest
>> version. We can have the significant info for each version in same pages.
>>
>> This is just my personal opinion.
>>
>>
>> On Tue, Dec 3, 2013 at 3:30 AM, Mariangela Hills <ma...@wso2.com>wrote:
>>
>>> The wiki is powered by Confluence. In Confluence each page name needs to
>>> be unique. Therefore, we can not have two pages with the same name.
>>>
>>> How about we use one of the following structures for the manuals. The
>>> following structures are based on a hypothetical scenario, taking into
>>> account that we have released 4.0.0 and we are working on the docs of a new
>>> release (e.g., 5.0.0) which has not been released yet.
>>> (1)
>>> - Documentation
>>>     - 4.0.0-incubating
>>>         - 4.0.0 Getting Started
>>>         - 4.0.0 User Guide
>>>         - 4.0.0 Developer Guide
>>>         - 4.0.0 Testing Procedure
>>>     - 3.0.0-incubating
>>>         - 3.0.0 Getting Started
>>>         - 3.0.0 User Guide
>>>         - 3.0.0 Developer Guide
>>>         - 3.0.0 Testing Procedure
>>>   - Future Release
>>>     - 5.0.0-incubating
>>>         - 5.0.0 Getting Started
>>>         - 5.0.0 User Guide
>>>         - 5.0.0 Developer Guide
>>>         - 5.0.0 Testing Procedure
>>>
>>> (2)
>>> - Documentation
>>>   - 4.0.0-incubating
>>>         - 4.0.0 Getting Started
>>>         - 4.0.0 User Guide
>>>         - 4.0.0 Developer Guide
>>>         - 4.0.0 Testing Procedure
>>>  - Archives
>>>     - 3.0.0-incubating
>>>         - 3.0.0 Getting Started
>>>         - 3.0.0 User Guide
>>>         - 3.0.0 Developer Guide
>>>         - 3.0.0 Testing Procedure
>>>  - Future Release
>>>     - 5.0.0-incubating
>>>         - 5.0.0 Getting Started
>>>         - 5.0.0 User Guide
>>>         - 5.0.0 Developer Guide
>>>         - 5.0.0 Testing Procedure
>>>
>>> Please let me know which structure is more suitable or whether you have
>>> a better idea.
>>> I vote for 2
>>>
>>> Regards,
>>> Mariangela
>>>
>>>
>>>
>>> *--Mariangela Hills*
>>> Senior Technical Writer
>>> Mobile:(+94)773500185
>>>
>>> WSO2 Inc. http://wso2.com/
>>>
>>>
>>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>
>>>> I think we could create a new Root Node called "Documentation" and move
>>>> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
>>>> each version. WDYT?
>>>>
>>>> Sample:
>>>>
>>>> - Documentation
>>>>     - 3.0.0-incubating
>>>>         - Getting Started
>>>>         - User Guide
>>>>         - Developer Guide
>>>>         - Testing Procedure
>>>>     - 4.0.0-incubating
>>>>         - Getting Started
>>>>         - User Guide
>>>>         - Developer Guide
>>>>         - Testing Procedure
>>>>
>>>>
>>>> Appreciate your feedback.
>>>>
>>>> Thanks
>>>> Imesh
>>>>
>>>>
>>>>
>>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>>
>>>>> Hi All,
>>>>>
>>>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>>>> like below:
>>>>>
>>>>> [image: Inline image 3]
>>>>>
>>>>> May be we could improve it by grouping the versions under a element
>>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>>
>>>>> [image: Inline image 4]
>>>>>
>>>>> What do you think?
>>>>>
>>>>> Thanks
>>>>> Imesh
>>>>>
>>>>
>>>>
>>>
>>
>>
>> --
>> Isuru Perera
>> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
>> Lean . Enterprise . Middleware
>>
>> about.me/chrishantha
>>
>
>
>
> --
> Best Regards,
> Nirmal
>
> Nirmal Fernando.
> PPMC Member & Committer of Apache Stratos,
> Senior Software Engineer, WSO2 Inc.
>
> Blog: http://nirmalfdo.blogspot.com/
>



-- 
Isuru Perera
Senior Software Engineer | WSO2, Inc. | http://wso2.com/
Lean . Enterprise . Middleware

about.me/chrishantha

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Nirmal Fernando <ni...@gmail.com>.
Oh... you can't always ask people to switch to the latest version :)
Impractical IMO.


On Wed, Dec 4, 2013 at 8:06 AM, Isuru Perera <is...@wso2.com> wrote:

> Do we really need to maintain docs for previous versions? Since we will be
> releasing versions in short durations, I don't think it's a good idea to
> restructure wiki like this. We will also be recommending to use latest
> version. We can have the significant info for each version in same pages.
>
> This is just my personal opinion.
>
>
> On Tue, Dec 3, 2013 at 3:30 AM, Mariangela Hills <ma...@wso2.com>wrote:
>
>> The wiki is powered by Confluence. In Confluence each page name needs to
>> be unique. Therefore, we can not have two pages with the same name.
>>
>> How about we use one of the following structures for the manuals. The
>> following structures are based on a hypothetical scenario, taking into
>> account that we have released 4.0.0 and we are working on the docs of a new
>> release (e.g., 5.0.0) which has not been released yet.
>> (1)
>> - Documentation
>>     - 4.0.0-incubating
>>         - 4.0.0 Getting Started
>>         - 4.0.0 User Guide
>>         - 4.0.0 Developer Guide
>>         - 4.0.0 Testing Procedure
>>     - 3.0.0-incubating
>>         - 3.0.0 Getting Started
>>         - 3.0.0 User Guide
>>         - 3.0.0 Developer Guide
>>         - 3.0.0 Testing Procedure
>>   - Future Release
>>     - 5.0.0-incubating
>>         - 5.0.0 Getting Started
>>         - 5.0.0 User Guide
>>         - 5.0.0 Developer Guide
>>         - 5.0.0 Testing Procedure
>>
>> (2)
>> - Documentation
>>   - 4.0.0-incubating
>>         - 4.0.0 Getting Started
>>         - 4.0.0 User Guide
>>         - 4.0.0 Developer Guide
>>         - 4.0.0 Testing Procedure
>>  - Archives
>>     - 3.0.0-incubating
>>         - 3.0.0 Getting Started
>>         - 3.0.0 User Guide
>>         - 3.0.0 Developer Guide
>>         - 3.0.0 Testing Procedure
>>  - Future Release
>>     - 5.0.0-incubating
>>         - 5.0.0 Getting Started
>>         - 5.0.0 User Guide
>>         - 5.0.0 Developer Guide
>>         - 5.0.0 Testing Procedure
>>
>> Please let me know which structure is more suitable or whether you have a
>> better idea.
>> I vote for 2
>>
>> Regards,
>> Mariangela
>>
>>
>>
>> *--Mariangela Hills*
>> Senior Technical Writer
>> Mobile:(+94)773500185
>>
>> WSO2 Inc. http://wso2.com/
>>
>>
>> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>
>>> I think we could create a new Root Node called "Documentation" and move
>>> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
>>> each version. WDYT?
>>>
>>> Sample:
>>>
>>> - Documentation
>>>     - 3.0.0-incubating
>>>         - Getting Started
>>>         - User Guide
>>>         - Developer Guide
>>>         - Testing Procedure
>>>     - 4.0.0-incubating
>>>         - Getting Started
>>>         - User Guide
>>>         - Developer Guide
>>>         - Testing Procedure
>>>
>>>
>>> Appreciate your feedback.
>>>
>>> Thanks
>>> Imesh
>>>
>>>
>>>
>>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>>
>>>> Hi All,
>>>>
>>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>>> like below:
>>>>
>>>> [image: Inline image 3]
>>>>
>>>> May be we could improve it by grouping the versions under a element
>>>> called "Documentation". Something similar to Axis2 Wiki:
>>>>
>>>> [image: Inline image 4]
>>>>
>>>> What do you think?
>>>>
>>>> Thanks
>>>> Imesh
>>>>
>>>
>>>
>>
>
>
> --
> Isuru Perera
> Senior Software Engineer | WSO2, Inc. | http://wso2.com/
> Lean . Enterprise . Middleware
>
> about.me/chrishantha
>



-- 
Best Regards,
Nirmal

Nirmal Fernando.
PPMC Member & Committer of Apache Stratos,
Senior Software Engineer, WSO2 Inc.

Blog: http://nirmalfdo.blogspot.com/

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Isuru Perera <is...@wso2.com>.
Do we really need to maintain docs for previous versions? Since we will be
releasing versions in short durations, I don't think it's a good idea to
restructure wiki like this. We will also be recommending to use latest
version. We can have the significant info for each version in same pages.

This is just my personal opinion.


On Tue, Dec 3, 2013 at 3:30 AM, Mariangela Hills <ma...@wso2.com>wrote:

> The wiki is powered by Confluence. In Confluence each page name needs to
> be unique. Therefore, we can not have two pages with the same name.
>
> How about we use one of the following structures for the manuals. The
> following structures are based on a hypothetical scenario, taking into
> account that we have released 4.0.0 and we are working on the docs of a new
> release (e.g., 5.0.0) which has not been released yet.
> (1)
> - Documentation
>     - 4.0.0-incubating
>         - 4.0.0 Getting Started
>         - 4.0.0 User Guide
>         - 4.0.0 Developer Guide
>         - 4.0.0 Testing Procedure
>     - 3.0.0-incubating
>         - 3.0.0 Getting Started
>         - 3.0.0 User Guide
>         - 3.0.0 Developer Guide
>         - 3.0.0 Testing Procedure
>   - Future Release
>     - 5.0.0-incubating
>         - 5.0.0 Getting Started
>         - 5.0.0 User Guide
>         - 5.0.0 Developer Guide
>         - 5.0.0 Testing Procedure
>
> (2)
> - Documentation
>   - 4.0.0-incubating
>         - 4.0.0 Getting Started
>         - 4.0.0 User Guide
>         - 4.0.0 Developer Guide
>         - 4.0.0 Testing Procedure
>  - Archives
>     - 3.0.0-incubating
>         - 3.0.0 Getting Started
>         - 3.0.0 User Guide
>         - 3.0.0 Developer Guide
>         - 3.0.0 Testing Procedure
>  - Future Release
>     - 5.0.0-incubating
>         - 5.0.0 Getting Started
>         - 5.0.0 User Guide
>         - 5.0.0 Developer Guide
>         - 5.0.0 Testing Procedure
>
> Please let me know which structure is more suitable or whether you have a
> better idea.
> I vote for 2
>
> Regards,
> Mariangela
>
>
>
> *--Mariangela Hills*
> Senior Technical Writer
> Mobile:(+94)773500185
>
> WSO2 Inc. http://wso2.com/
>
>
> On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org> wrote:
>
>> I think we could create a new Root Node called "Documentation" and move
>> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
>> each version. WDYT?
>>
>> Sample:
>>
>> - Documentation
>>     - 3.0.0-incubating
>>         - Getting Started
>>         - User Guide
>>         - Developer Guide
>>         - Testing Procedure
>>     - 4.0.0-incubating
>>         - Getting Started
>>         - User Guide
>>         - Developer Guide
>>         - Testing Procedure
>>
>>
>> Appreciate your feedback.
>>
>> Thanks
>> Imesh
>>
>>
>>
>> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org>wrote:
>>
>>> Hi All,
>>>
>>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>>> like below:
>>>
>>> [image: Inline image 3]
>>>
>>> May be we could improve it by grouping the versions under a element
>>> called "Documentation". Something similar to Axis2 Wiki:
>>>
>>> [image: Inline image 4]
>>>
>>> What do you think?
>>>
>>> Thanks
>>> Imesh
>>>
>>
>>
>


-- 
Isuru Perera
Senior Software Engineer | WSO2, Inc. | http://wso2.com/
Lean . Enterprise . Middleware

about.me/chrishantha

Re: [Discuss] [Wiki] Maintaining Verisions in Apache Stratos (incubating) Wiki

Posted by Mariangela Hills <ma...@wso2.com>.
The wiki is powered by Confluence. In Confluence each page name needs to be
unique. Therefore, we can not have two pages with the same name.

How about we use one of the following structures for the manuals. The
following structures are based on a hypothetical scenario, taking into
account that we have released 4.0.0 and we are working on the docs of a new
release (e.g., 5.0.0) which has not been released yet.
(1)
- Documentation
    - 4.0.0-incubating
        - 4.0.0 Getting Started
        - 4.0.0 User Guide
        - 4.0.0 Developer Guide
        - 4.0.0 Testing Procedure
    - 3.0.0-incubating
        - 3.0.0 Getting Started
        - 3.0.0 User Guide
        - 3.0.0 Developer Guide
        - 3.0.0 Testing Procedure
  - Future Release
    - 5.0.0-incubating
        - 5.0.0 Getting Started
        - 5.0.0 User Guide
        - 5.0.0 Developer Guide
        - 5.0.0 Testing Procedure

(2)
- Documentation
  - 4.0.0-incubating
        - 4.0.0 Getting Started
        - 4.0.0 User Guide
        - 4.0.0 Developer Guide
        - 4.0.0 Testing Procedure
 - Archives
    - 3.0.0-incubating
        - 3.0.0 Getting Started
        - 3.0.0 User Guide
        - 3.0.0 Developer Guide
        - 3.0.0 Testing Procedure
 - Future Release
    - 5.0.0-incubating
        - 5.0.0 Getting Started
        - 5.0.0 User Guide
        - 5.0.0 Developer Guide
        - 5.0.0 Testing Procedure

Please let me know which structure is more suitable or whether you have a
better idea.
I vote for 2

Regards,
Mariangela



*--Mariangela Hills*
Senior Technical Writer
Mobile:(+94)773500185

WSO2 Inc. http://wso2.com/


On Mon, Dec 2, 2013 at 10:59 AM, Imesh Gunaratne <im...@apache.org> wrote:

> I think we could create a new Root Node called "Documentation" and move
> "Getting Started", "User Guide", "Developer Guide", "Testing Procedure" to
> each version. WDYT?
>
> Sample:
>
> - Documentation
>     - 3.0.0-incubating
>         - Getting Started
>         - User Guide
>         - Developer Guide
>         - Testing Procedure
>     - 4.0.0-incubating
>         - Getting Started
>         - User Guide
>         - Developer Guide
>         - Testing Procedure
>
>
> Appreciate your feedback.
>
> Thanks
> Imesh
>
>
>
> On Sat, Nov 30, 2013 at 8:34 AM, Imesh Gunaratne <im...@apache.org> wrote:
>
>> Hi All,
>>
>> Currently Apache Stratos (incubating) Wiki navigation structure looks
>> like below:
>>
>> [image: Inline image 3]
>>
>> May be we could improve it by grouping the versions under a element
>> called "Documentation". Something similar to Axis2 Wiki:
>>
>> [image: Inline image 4]
>>
>> What do you think?
>>
>> Thanks
>> Imesh
>>
>
>