Thanks Patrick. In the meantime Terence had tried out the maven site plugin and I think it looks pretty good. I just added a couple of links.
Everybody, the current state is in a branch "site", just check it out and run mvn site and you can see it in your browser under target/site/index.html. How does this look? Is this good enough for an initial website? On Wed, Dec 11, 2013 at 9:41 PM, Patrick Hunt <[email protected]> wrote: > iirc you can use maven to generate the site and still use CMS. It's > been a while since I looked at it though. Here are some pages to start > with: > > https://www.apache.org/dev/cmsref.html#external-build > https://blogs.apache.org/infra/entry/apache_cms_and_external_build > http://apache.org/dev/cmsadoption.html > http://www.apache.org/dev/cms.html > > Patrick > > On Tue, Dec 10, 2013 at 6:14 PM, Andreas Neumann <[email protected]> wrote: > > I have already discarded Sphinx, even though I like it, it seems more > > appropriate to use a tool that is standard in the Apache community. > > > > I like the suggestion to distinguish between site, wiki, and docs. For > the > > site, I see that many projects use the maven site plugin to generate the > > site, that seems to be the most self-contained and straight-forward > > solution, because maven is a prereq for building Twill anyway. Is there a > > clear advantage of using CMS over maven? > > > > -Andreas. > > > > > > On Tue, Dec 10, 2013 at 4:31 PM, Patrick Hunt <[email protected]> wrote: > > > >> Take a look at what we did for whirr, there's alot of background here: > >> https://issues.apache.org/jira/browse/WHIRR-19 > >> > >> I'd strongly suggest you use (or at least seriously consider) Apache > >> CMS. One question you should answer; what will be on the site, vs on > >> the wiki, vs in docs that ship with the release. IMO keeping the site > >> light, frequently updated docs in wiki, and apis in the release work > >> well. See cassandra for an example in the extreme: > >> http://cassandra.apache.org/ > >> > >> Patrick > >> > >> On Tue, Dec 10, 2013 at 1:33 PM, Andreas Neumann <[email protected]> > wrote: > >> > Since I did not get a response on this, I will assign to myself and > take > >> a > >> > first stab. I am gonna try a couple of tools including mvn and sphinx > and > >> > share the results. > >> > -Andreas. > >> > > >> > > >> > On Fri, Dec 6, 2013 at 11:40 AM, Andreas Neumann <[email protected]> > >> wrote: > >> > > >> >> Everybody, > >> >> > >> >> bootstrapping the Twill podling is almost complete and the only > >> remaining > >> >> task is to create the website. (TWILL-14). > >> >> > >> >> A good way to start would be take the existing Weave introduction at > >> >> github (https://github.com/continuuity/weave) and adapt it to > Apache. > >> But > >> >> before we can do that, we need to agree on the tool that we want to > use > >> to > >> >> create and maintain the website. We could use the Apache CMS, we > could > >> use > >> >> the maven plugin, or we could choose a different tool as long as its > >> >> license allows us to use it and check it in with the source. > >> >> > >> >> What do folks on the list suggest / prefer? > >> >> > >> >> Cheers -Andreas. > >> >> > >> >
