You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@creadur.apache.org by Robert Burrell Donkin <ro...@blueyonder.co.uk> on 2012/11/06 21:28:17 UTC

[WAS Re: Release Rat ...?]

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

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?

Robert
[1] http://creadur.apache.org/rat/apache-rat-core/index.html

Re: Rat 0.9 TODO [WAS Re: Release Rat ...?]

Posted by Robert Burrell Donkin <ro...@blueyonder.co.uk>.
On 11/24/12 00:40, Dennis Lundberg wrote:
> On 2012-11-21 21:59, Robert Burrell Donkin wrote:
>> On 11/06/12 20:45, Dennis Lundberg wrote:
>>> 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.
>>
>> How close are we now...?
>
> We're there.
> I've update a few Maven plugins to fix a few problems with the build.

:-)

>>>>> I have these things left on my todo list:
>>>>>
>>>>> A. Rewrite site for core module, which is now in JIRA as RAT-123
>>
>> Consensus seems to be that this is good enough for now
>
> I agree.

:-)

>>>>> B. Add xml schema to assembly descriptors and site descriptors, so that
>>>>> they can be validated
>>
>> How much is left to do...?
>
> All done.

:-)

>>>>> C. Rewrite src/site/apt/site-publish.apt, given that we're not in the
>>>>> incubator any more
>>
>> I've reworked and published to
>> http://creadur.apache.org/rat/site-publish.html
>
> I took it for a test drive and made a few minor tweaks.

:-)

Robert

Re: Rat 0.9 TODO [WAS Re: Release Rat ...?]

Posted by Dennis Lundberg <de...@apache.org>.
On 2012-11-21 21:59, Robert Burrell Donkin wrote:
> On 11/06/12 20:45, Dennis Lundberg wrote:
>> 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.
> 
> How close are we now...?

We're there.
I've update a few Maven plugins to fix a few problems with the build.

>>>> I have these things left on my todo list:
>>>>
>>>> A. Rewrite site for core module, which is now in JIRA as RAT-123
> 
> Consensus seems to be that this is good enough for now

I agree.

>>>> B. Add xml schema to assembly descriptors and site descriptors, so that
>>>> they can be validated
> 
> How much is left to do...?

All done.

>>>> C. Rewrite src/site/apt/site-publish.apt, given that we're not in the
>>>> incubator any more
> 
> I've reworked and published to
> http://creadur.apache.org/rat/site-publish.html

I took it for a test drive and made a few minor tweaks.

> Robert


-- 
Dennis Lundberg

Rat 0.9 TODO [WAS Re: Release Rat ...?]

Posted by Robert Burrell Donkin <ro...@blueyonder.co.uk>.
On 11/06/12 20:45, Dennis Lundberg wrote:
> 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.

How close are we now...?

>>> I have these things left on my todo list:
>>>
>>> A. Rewrite site for core module, which is now in JIRA as RAT-123

Consensus seems to be that this is good enough for now

>>> B. Add xml schema to assembly descriptors and site descriptors, so that
>>> they can be validated

How much is left to do...?

>>> C. Rewrite src/site/apt/site-publish.apt, given that we're not in the
>>> incubator any more

I've reworked and published to 
http://creadur.apache.org/rat/site-publish.html

Robert

Re: [WAS Re: Release Rat ...?]

Posted by Dennis Lundberg <de...@apache.org>.
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