You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by David Crossley <cr...@indexgeo.com.au> on 2002/11/13 11:19:57 UTC
doc that warns about known future changes
Nicola Ken Barozzi wrote:
> Steven Noels wrote:
> > Nicola Ken Barozzi wrote:
> >>Steven Noels wrote:
> >>
> >>> So who is supposed now to clean up the existing
> >>> src/resources/library/xslt mess?
> >>
> >> Are you volunteering?
> >
> > Nope.
> >
> > And I'll feel bad if David has to play housemaid once again.
> >
> > Let's make this a rule: if you break stuff or add new things which make
> > existing things obsolete, you have to provide a migration path or clean
> > up yourself.
>
> With the convert stuff I haven't broken anything, and have followed IIUC
> David's suggestion.
>
>
> David Crossley wrote:
> [...]
> > so it seems better to me to have src/resources/convert
> ^^^^^^^^^^^
> > with type-specific sub-dirs to hold all of their resources,
> > e.g. /maven/*.xsl, /maven/build.xml, etc.). Otherwise
> > we will need strange filenames to distinguish each.
>
> Do you read the mails? :-|
>
> There is no migration path, they are simply different things.
> Eventually we will use that instead of what is in the library but not
> now. CVS is not sacred, I won't commit things just when I've done with
> it, because it's wrong.
>
> As for the sitemap, I've reverted it.
I gather that you are talking about the revert
of the /content/xdocs/ stuff. Is that reversion
reflected in status.xml now? It looks like the wrong
action has been hidden.
> > When I'll be fixing DTDs soon, I'll make sure to live by the same rule.
> >
> > </Steven>
It sounds like we need a document that lists the things that
we know are going to change in future releases, e.g. moving
some relevant *.xsl from resources/library/xslt/ into
resources/convert/
--David
Re: doc that warns about known future changes
Posted by Jeff Turner <je...@apache.org>.
On Wed, Nov 13, 2002 at 09:40:11PM +1100, David Crossley wrote:
...
> > Hmmm, Jeff IIRC removed it... you mean we should keep track of all
> > actions and reverts?
>
> Hell no, not at all necessary.
>
> Look at status.xml ... The <change><action> about /convert/
> has been hidden, whereas i see that your sitemap revert
> was about the next item in <status><changes> ...
> ----
> <release version="0.2rc1" date="2002-11-13">
> <!--
> <action dev="NKB" type="update" context="utils">
> Added a convert dir in the resources with stylesheets
> and buildfile to help convert Anakia and Maven-based sites.
> </action>
> -->
> <action dev="NKB" type="update" context="webapp">
> Now Forrest will look for xdocs in the content dir first,
> and fallback to the legacy xdocs dir.
> </action>
> ----
Sorry.. commented out the wrong thing. Fixed.
--Jeff
Re: doc that warns about known future changes
Posted by David Crossley <cr...@indexgeo.com.au>.
Nicola Ken Barozzi wrote:
> David Crossley wrote:
> > Nicola Ken Barozzi wrote:
> >
> >>Steven Noels wrote:
> >>
> >>>Nicola Ken Barozzi wrote:
> >>>
> >>>>Steven Noels wrote:
> >>>>
> >>>>
> >>>>>So who is supposed now to clean up the existing
> >>>>>src/resources/library/xslt mess?
> >>>>
> >>>>Are you volunteering?
> >>>
> >>>Nope.
> >>>
> >>>And I'll feel bad if David has to play housemaid once again.
> >>>
> >>>Let's make this a rule: if you break stuff or add new things which make
> >>>existing things obsolete, you have to provide a migration path or clean
> >>>up yourself.
> >>
> >>With the convert stuff I haven't broken anything, and have followed IIUC
> >>David's suggestion.
> >>
> >>
> >>David Crossley wrote:
> >>[...]
> >> > so it seems better to me to have src/resources/convert
> >> ^^^^^^^^^^^
> >> > with type-specific sub-dirs to hold all of their resources,
> >> > e.g. /maven/*.xsl, /maven/build.xml, etc.). Otherwise
> >> > we will need strange filenames to distinguish each.
> >>
> >>Do you read the mails? :-|
> >>
> >>There is no migration path, they are simply different things.
> >>Eventually we will use that instead of what is in the library but not
> >>now. CVS is not sacred, I won't commit things just when I've done with
> >>it, because it's wrong.
> >>
> >>As for the sitemap, I've reverted it.
> >
> >
> > I gather that you are talking about the revert
> > of the /content/xdocs/ stuff. Is that reversion
> > reflected in status.xml now? It looks like the wrong
> > action has been hidden.
>
> Hmmm, Jeff IIRC removed it... you mean we should keep track of all
> actions and reverts?
Hell no, not at all necessary.
Look at status.xml ... The <change><action> about /convert/
has been hidden, whereas i see that your sitemap revert
was about the next item in <status><changes> ...
----
<release version="0.2rc1" date="2002-11-13">
<!--
<action dev="NKB" type="update" context="utils">
Added a convert dir in the resources with stylesheets
and buildfile to help convert Anakia and Maven-based sites.
</action>
-->
<action dev="NKB" type="update" context="webapp">
Now Forrest will look for xdocs in the content dir first,
and fallback to the legacy xdocs dir.
</action>
----
> >>>When I'll be fixing DTDs soon, I'll make sure to live by the same rule.
> >>>
> >>></Steven>
> >
> > It sounds like we need a document that lists the things that
> > we know are going to change in future releases, e.g. moving
> > some relevant *.xsl from resources/library/xslt/ into
> > resources/convert/
Re: doc that warns about known future changes
Posted by Nicola Ken Barozzi <ni...@apache.org>.
David Crossley wrote:
> Nicola Ken Barozzi wrote:
>
>>Steven Noels wrote:
>>
>>>Nicola Ken Barozzi wrote:
>>>
>>>>Steven Noels wrote:
>>>>
>>>>
>>>>>So who is supposed now to clean up the existing
>>>>>src/resources/library/xslt mess?
>>>>
>>>>Are you volunteering?
>>>
>>>Nope.
>>>
>>>And I'll feel bad if David has to play housemaid once again.
>>>
>>>Let's make this a rule: if you break stuff or add new things which make
>>>existing things obsolete, you have to provide a migration path or clean
>>>up yourself.
>>
>>With the convert stuff I haven't broken anything, and have followed IIUC
>>David's suggestion.
>>
>>
>>David Crossley wrote:
>>[...]
>> > so it seems better to me to have src/resources/convert
>> ^^^^^^^^^^^
>> > with type-specific sub-dirs to hold all of their resources,
>> > e.g. /maven/*.xsl, /maven/build.xml, etc.). Otherwise
>> > we will need strange filenames to distinguish each.
>>
>>Do you read the mails? :-|
>>
>>There is no migration path, they are simply different things.
>>Eventually we will use that instead of what is in the library but not
>>now. CVS is not sacred, I won't commit things just when I've done with
>>it, because it's wrong.
>>
>>As for the sitemap, I've reverted it.
>
>
> I gather that you are talking about the revert
> of the /content/xdocs/ stuff. Is that reversion
> reflected in status.xml now? It looks like the wrong
> action has been hidden.
Hmmm, Jeff IIRC removed it... you mean we should keep track of all
actions and reverts?
>>>When I'll be fixing DTDs soon, I'll make sure to live by the same rule.
>>>
>>></Steven>
>>
>
> It sounds like we need a document that lists the things that
> we know are going to change in future releases, e.g. moving
> some relevant *.xsl from resources/library/xslt/ into
> resources/convert/
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------