creadur-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dennis Lundberg <denn...@apache.org>
Subject Re: [WAS Re: Release Rat ...?]
Date Tue, 06 Nov 2012 20:45:58 GMT
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

Mime
View raw message