Ralph, if you need some help, let me know. Next weekend I've time. - Alex
On Jun 28, 2012, at 11:23 PM, Ralph Goers wrote: > OK - I will try to get something going this weekend. > > Ralph > > On Jun 28, 2012, at 1:54 PM, Arvind Prabhakar wrote: > >> Hi Ralph, >> >> Since there are no objections or suggestions other than what you have >> previously described, I suggest you proceed with how you would like this to >> be setup. For the time being I have created an infrastructure request to >> setup the website infrastructure [1]. Please feel free to modify that >> request or add details to it as you feel fit. >> >> [1] https://issues.apache.org/jira/browse/INFRA-4982 >> >> Regards, >> Arvind Prabhakar >> >> On Sun, Jun 24, 2012 at 11:32 PM, Arvind Prabhakar <[email protected]>wrote: >> >>> Hi, >>> >>> On Sun, Jun 24, 2012 at 3:16 PM, Ralph Goers >>> <[email protected]>wrote: >>> >>>> I guess I've embedded the discussion on the web site in with this >>>> discussion and the OOM issues because how the documentation is generated is >>>> related to how it is displayed on the web site and the problems the build >>>> was/is having. >>>> >>>> I am very tempted to go ahead and create a Sphinx-baesd web site starting >>>> with what you've already done, but I don't want to waste my time if that >>>> isn't what is wanted. If I did this it would be built by the CMS system and >>>> therefore would reside in something like >>>> https://svn.apache.org/repos/asf/flume/site/cms/trunk instead of the >>>> main source trunk. >>> >>> >>> My +1 and thanks for doing this. The website needs to be updated and >>> manageable so if you have the necessary cycles, then please do go ahead >>> with it. Currently the site lives in [1] and uses basic xdoc for >>> structured content. Personally, I have no objections to continue using xdoc >>> or moving to a different tool if you feel would add more value. >>> >>> [1] https://svn.apache.org/repos/asf/incubator/flume/site/ >>> >>> >>>> However, it should be possible to capture the documentation into the >>>> release distribution if that is desired or required. >>> >>> >>> While some projects maintain most up to date documentation on the site, >>> IMO it is better to have versioned documentation that corresponds to the >>> release versions available right at the webstie. >>> >>> Regards, >>> Arvind Prabhakar >>> >>> >>>> >>>> Ralph >>>> >>>> Re: [DISCUSS] documentation formats >>>> >>>> On Jun 24, 2012, at 1:42 PM, Mike Percy wrote: >>>> >>>>> I don't think there has been a discussion of how to build the website. >>>> If that is something you want to work on, you could always start a discuss >>>> thread about it. Sphinx has a ton of theming and format output options. >>>>> >>>>> Regards, >>>>> Mike >>>>> >>>> >>> >>> > -- Alexander Alten-Lorenz http://mapredit.blogspot.com German Hadoop LinkedIn Group: http://goo.gl/N8pCF
