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 >>>> >>> >> >>
