+1 to Isuru's idea. The plan is to gradually retire the old docs and completely move to wiki. It is easier for users to have a single place to refer to in terms of formal product documentation, which can have links to other resources where applicable.
Thanks, -Nirdesha On Mon, Jun 25, 2012 at 1:10 PM, Isuru Suriarachchi <is...@wso2.com> wrote: > > > On Mon, Jun 25, 2012 at 1:05 PM, Senaka Fernando <sen...@wso2.com> wrote: > >> Java API docs can't be written on the wiki docs, :). These are javadocs >> and need to be packed in this way, isn't it? > > > You don't have to write java docs on the wiki :). Host it somewhere and > point to that from the wiki based doc. Having java docs on a different > distribution and having other docs on the wiki is a mess. All should be in > a single place. > > Thanks, > ~Isuru > > >> >> Thanks, >> Senaka. >> >> >> On Mon, Jun 25, 2012 at 1:02 PM, Isuru Suriarachchi <is...@wso2.com>wrote: >> >>> >>> >>> On Mon, Jun 25, 2012 at 1:00 PM, Senaka Fernando <sen...@wso2.com>wrote: >>> >>>> Hi all, >>>> >>>> FYI, we have already removed docs from G-Reg distro, but we still build >>>> a docs pack that contains the release note, and the Java APIs, details on >>>> checking out source etc >>>> >>> >>> Why can't we move these also to the wiki based documentation and >>> completely get rid of the docs pack? >>> >>> Thanks, >>> ~Isuru >>> >>> >>>> (auto-generated by Maven), and several hyperlinks. >>>> >>>> Thanks, >>>> Senaka. >>>> >>>> >>>> On Mon, Jun 25, 2012 at 11:37 AM, Supun Malinga <sup...@wso2.com>wrote: >>>> >>>>> >>>>> >>>>> On Mon, Jun 25, 2012 at 11:31 AM, Isuru Suriarachchi >>>>> <is...@wso2.com>wrote: >>>>> >>>>>> As we are getting closer to the release now it's time to concentrate >>>>>> on the documentation as well. According to Nirdesha, she has already done >>>>>> the wiki based documentation for AS 4.1.2 [1]. So we have to create a new >>>>>> doc for 5.0.0 and include all the new features and changes done for the >>>>>> existing features. >>>>>> >>>>>> I think with this new wiki based documentation, we don't need docs >>>>>> packs through the build. Now we only need the context sensitive helps >>>>>> coming from each component. Shall we remove doc pack generation from the >>>>>> build?? >>>>>> >>>>> +1 >>>>> lets make sure we incorporate all the stuff in doc packs in the wiki. >>>>> >>>>> thanks, >>>>> >>>>>> >>>>>> Thanks, >>>>>> ~Isuru >>>>>> >>>>>> [1] >>>>>> http://docs.wso2.org/wiki/display/AS412/WSO2+Application+Server+Documentation >>>>>> >>>>>> -- >>>>>> Isuru Suriarachchi >>>>>> Senior Technical Lead >>>>>> WSO2 Inc. http://wso2.com >>>>>> email : is...@wso2.com >>>>>> blog : http://isurues.wordpress.com/ >>>>>> >>>>>> lean . enterprise . middleware >>>>>> >>>>>> >>>>>> _______________________________________________ >>>>>> Dev mailing list >>>>>> Dev@wso2.org >>>>>> http://wso2.org/cgi-bin/mailman/listinfo/dev >>>>>> >>>>>> >>>>> >>>>> >>>>> -- >>>>> Supun Malinga, >>>>> >>>>> Software Engineer, >>>>> WSO2 Inc. >>>>> http://wso2.com >>>>> http://wso2.org >>>>> email - sup...@wso2.com <sup...@wso2.com> >>>>> mobile - 071 56 91 321 >>>>> >>>>> >>>>> _______________________________________________ >>>>> Dev mailing list >>>>> Dev@wso2.org >>>>> http://wso2.org/cgi-bin/mailman/listinfo/dev >>>>> >>>>> >>>> >>>> >>>> -- >>>> *Senaka Fernando* >>>> Member - Integration Technologies Management Committee; >>>> Technical Lead; WSO2 Inc.; http://wso2.com >>>> * >>>> Member; Apache Software Foundation; http://apache.org >>>> >>>> E-mail: senaka AT wso2.com >>>> **P: +1 408 754 7388; ext: 51736*; *M: +94 77 322 1818 >>>> Linked-In: http://linkedin.com/in/senakafernando >>>> >>>> *Lean . Enterprise . Middleware >>>> >>>> >>> >>> >>> -- >>> Isuru Suriarachchi >>> Senior Technical Lead >>> WSO2 Inc. http://wso2.com >>> email : is...@wso2.com >>> blog : http://isurues.wordpress.com/ >>> >>> lean . enterprise . middleware >>> >>> >> >> >> -- >> *Senaka Fernando* >> Member - Integration Technologies Management Committee; >> Technical Lead; WSO2 Inc.; http://wso2.com* >> Member; Apache Software Foundation; http://apache.org >> >> E-mail: senaka AT wso2.com >> **P: +1 408 754 7388; ext: 51736*; *M: +94 77 322 1818 >> Linked-In: http://linkedin.com/in/senakafernando >> >> *Lean . Enterprise . Middleware >> >> > > > -- > Isuru Suriarachchi > Senior Technical Lead > WSO2 Inc. http://wso2.com > email : is...@wso2.com > blog : http://isurues.wordpress.com/ > > lean . enterprise . middleware > > > _______________________________________________ > Dev mailing list > Dev@wso2.org > http://wso2.org/cgi-bin/mailman/listinfo/dev > > -- Thanks, Nirdesha Munasinghe, WSO2 Inc. Web:http://wso2.com Mobile: +94 776321920
_______________________________________________ Dev mailing list Dev@wso2.org http://wso2.org/cgi-bin/mailman/listinfo/dev