On 2012-11-06 21:28, Robert Burrell Donkin wrote: > On 11/04/12 16:52, Dennis Lundberg wrote: >> On 2012-11-04 16:14, Robert Burrell Donkin wrote: > > <snip> > >>> On 09/23/12 21:29, Dennis Lundberg wrote: >>> Does it make sense to start working towards a new release...? >> >> Yes, I think so. I have these things left on my todo list: >> >> A. Rewrite site for core module, which is now in JIRA as RAT-123 >> B. Add xml schema to assembly descriptors and site descriptors, so that >> they can be validated >> C. Rewrite src/site/apt/site-publish.apt, given that we're not in the >> incubator any more >> >> - Robert has assigned A to himself. > > I've regenerated the Rat subsite with the beginnings of some content for > core[1]. Feedback welcomed :-)
Looks good to me. > One of the problems posed by improving the documentation is that Rat > core really needs a good refactor into a much simpler and conventional > design. This would probably mean adding more integration tests before > starting. > > There a balance that needs to be struck between better documentation > about the current mess, and moving towards a more reasonable design. > > Opinions? Suggestions? For now the documentation for Rat core is good enough. At least it is about Rat core now :) Going forward we can improve the docs as needed if/when a refactoring takes place. > > Robert > [1] http://creadur.apache.org/rat/apache-rat-core/index.html -- Dennis Lundberg
