You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by "Thorsten Scherler (JIRA)" <ji...@apache.org> on 2006/04/21 01:21:06 UTC

[jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

    [ http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 ] 

Thorsten Scherler commented on FOR-797:
---------------------------------------

We should remove following contracts:

content-feeder.ft -> this is actually a feed2htmlSnippet contract but to clumpsy
content-main-lenya.ft -> obsolete
content-include-html.ft -> obsolete, can be done with genericXhtml
content-ls-contracts.ft -> never used
siteinfo-feedback-dyn.ft -> obsolete, only slight different markup in comparison

If nobody speaks up I will remove them in <24 hours.

> Move all v3 resources and code to the new plugins
> -------------------------------------------------
>
>          Key: FOR-797
>          URL: http://issues.apache.org/jira/browse/FOR-797
>      Project: Forrest
>         Type: Sub-task

>   Components: Dispatcher (aka views)
>     Reporter: Thorsten Scherler

>
> move all contracts from v3 to the new plugins and finish the contracts that have not been refactored so far

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Cyriaque Dupoirieux <Cy...@pcotech.fr>.
le 02/05/2006 12:41 Thorsten Scherler a écrit :
> El mar, 02-05-2006 a las 09:20 +0200, Cyriaque Dupoirieux escribió:
>   
>> le 29/04/2006 00:25 Ross Gardler a écrit :
>>     
>>> Cyriaque Dupoirieux wrote:
>>>       
>>>> le 21/04/2006 20:44 Thorsten Scherler a écrit :
>>>>
>>>>         
>>>> [SNIP]
> To easier recall
> http://svn.apache.org/viewcvs.cgi/forrest/trunk/whiteboard/plugins/org.apache.forrest.themes.core/themes/common/html/content-ls-contracts.ft?rev=373373&view=markup
>
> This contracts is waiting for xdocs as input format and will transform
> it to html. 
>
> However this transformation can be done with content-main (~-*). The ls
> contract was thought to be something like an overview contract (usable
> everywhere). It displays the same as
> http://localhost:8888/ls.contracts.html but it is *not* used in this
> page!
>
> The http://localhost:8888/ls.contracts.html is the overview of all
> forrest provided contracts including documentation/usage/... information
> about each contract. We use the "normal" content-main/-* contracts to
> display this page.
>   
Ok, that's exactly what I was afraid to loose ;-) .
So if the ls-contract has been replaced by I don't know what, It's Ok 
for me.

BTW the page doesn't display my project specific contracts, we may find 
a way to add them in a different sections :

    * Standard contracts, theme name: common
    * Project specific contracts, theme name: common
    * Standard contracts, theme name: pelt
    * Project specific contracts, theme name: pelt


Is it possible ?

Salutations,
Cyriaque,
> The content-ls-contracts.ft is heavily out of sync (not only the
> contract-grammar but as well the awaited input format). Since I have not
> seen a useful use case for the contract I thought we should just drop
> it.
>
> ...but I am happy to keep it. ;) If we decide to keep it needs work to
> add some filter as forrest:property to limit the output to a reasonable
> set of information and an update of the xsl:templates to reflect current
> ls.contracts.xml as input.
>
> salu2
>   

Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Thorsten Scherler <th...@wyona.com>.
El mar, 02-05-2006 a las 09:20 +0200, Cyriaque Dupoirieux escribió:
> le 29/04/2006 00:25 Ross Gardler a écrit :
> > Cyriaque Dupoirieux wrote:
> >> le 21/04/2006 20:44 Thorsten Scherler a écrit :
> >>
> >>> El vie, 21-04-2006 a las 09:55 +0200, Cyriaque Dupoirieux escribió:
> >>>  
> >>>
> >>>> le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
> >>>>   
> >>>>>     [ 
> >>>>> http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 
> >>>>> ]
> >>>>> Thorsten Scherler commented on FOR-797:
> >>>>> ---------------------------------------
> >>>>>
> >>>>> We should remove following contracts:
> >>>>>
> >>>>> content-feeder.ft -> this is actually a feed2htmlSnippet contract 
> >>>>> but to clumpsy
> >>>>> content-main-lenya.ft -> obsolete
> >>>>> content-include-html.ft -> obsolete, can be done with genericXhtml
> >>>>> content-ls-contracts.ft -> never used
> >>>>>         
> >>>>
> >>>> Was this the contract which displayed a list of available contracts 
> >>>> (standard and custom) ?
> >>>>     
> >>>
> >>>
> >>> yes, but IMO that is not really suitable since the descriptions are
> >>> quite big.
> >>> Why do you ask, do you think we should keep it?
> >>>   
> >>
> >> If your are talking about the content-ls-contracts, I think it was 
> >> very nice and useful to have an automatic generated documentation of 
> >> every contracts available for a project.
> >> It was also interesting to generate the page and include it in the 
> >> forrest site - in the dispatcher documentation - just like we do with 
> >> the DTDs.
> >
> > Like Cyriaque I don't fully understand the problem that Thorsten sees. 
> 
> > But I do think auto generated documentation like this is a very good idea.
> You do or you don't think ?
> (The "But" at the beginning of your sentence leave me puzzled... )
> 
> Cyriaque,
> > If it is replaced with something better then fine, go ahead and remove 
> > it, otherwise lets keep it since it is the best we have.
> >

To easier recall
http://svn.apache.org/viewcvs.cgi/forrest/trunk/whiteboard/plugins/org.apache.forrest.themes.core/themes/common/html/content-ls-contracts.ft?rev=373373&view=markup

This contracts is waiting for xdocs as input format and will transform
it to html. 

However this transformation can be done with content-main (~-*). The ls
contract was thought to be something like an overview contract (usable
everywhere). It displays the same as
http://localhost:8888/ls.contracts.html but it is *not* used in this
page!

The http://localhost:8888/ls.contracts.html is the overview of all
forrest provided contracts including documentation/usage/... information
about each contract. We use the "normal" content-main/-* contracts to
display this page.

The content-ls-contracts.ft is heavily out of sync (not only the
contract-grammar but as well the awaited input format). Since I have not
seen a useful use case for the contract I thought we should just drop
it.

...but I am happy to keep it. ;) If we decide to keep it needs work to
add some filter as forrest:property to limit the output to a reasonable
set of information and an update of the xsl:templates to reflect current
ls.contracts.xml as input.

salu2
-- 
Thorsten Scherler
COO Spain
Wyona Inc.  -  Open Source Content Management  -  Apache Lenya
http://www.wyona.com                   http://lenya.apache.org
thorsten.scherler@wyona.com                thorsten@apache.org


Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Ross Gardler <rg...@apache.org>.
Cyriaque Dupoirieux wrote:
> le 29/04/2006 00:25 Ross Gardler a écrit :
> 

...

>> But I do think auto generated documentation like this is a very good 
>> idea.
> 
> You do or you don't think ?
> (The "But" at the beginning of your sentence leave me puzzled... )


I do think auto generated docs are good.

Ross


Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Cyriaque Dupoirieux <Cy...@pcotech.fr>.
le 29/04/2006 00:25 Ross Gardler a écrit :
> Cyriaque Dupoirieux wrote:
>> le 21/04/2006 20:44 Thorsten Scherler a écrit :
>>
>>> El vie, 21-04-2006 a las 09:55 +0200, Cyriaque Dupoirieux escribió:
>>>  
>>>
>>>> le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
>>>>   
>>>>>     [ 
>>>>> http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 
>>>>> ]
>>>>> Thorsten Scherler commented on FOR-797:
>>>>> ---------------------------------------
>>>>>
>>>>> We should remove following contracts:
>>>>>
>>>>> content-feeder.ft -> this is actually a feed2htmlSnippet contract 
>>>>> but to clumpsy
>>>>> content-main-lenya.ft -> obsolete
>>>>> content-include-html.ft -> obsolete, can be done with genericXhtml
>>>>> content-ls-contracts.ft -> never used
>>>>>         
>>>>
>>>> Was this the contract which displayed a list of available contracts 
>>>> (standard and custom) ?
>>>>     
>>>
>>>
>>> yes, but IMO that is not really suitable since the descriptions are
>>> quite big.
>>> Why do you ask, do you think we should keep it?
>>>   
>>
>> If your are talking about the content-ls-contracts, I think it was 
>> very nice and useful to have an automatic generated documentation of 
>> every contracts available for a project.
>> It was also interesting to generate the page and include it in the 
>> forrest site - in the dispatcher documentation - just like we do with 
>> the DTDs.
>
> Like Cyriaque I don't fully understand the problem that Thorsten sees. 

> But I do think auto generated documentation like this is a very good idea.
You do or you don't think ?
(The "But" at the beginning of your sentence leave me puzzled... )

Cyriaque,
> If it is replaced with something better then fine, go ahead and remove 
> it, otherwise lets keep it since it is the best we have.
>
> Ross
>
>

Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Ross Gardler <rg...@apache.org>.
Cyriaque Dupoirieux wrote:
> le 21/04/2006 20:44 Thorsten Scherler a écrit :
> 
>> El vie, 21-04-2006 a las 09:55 +0200, Cyriaque Dupoirieux escribió:
>>  
>>
>>> le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
>>>    
>>>
>>>>     [ 
>>>> http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 
>>>> ]
>>>> Thorsten Scherler commented on FOR-797:
>>>> ---------------------------------------
>>>>
>>>> We should remove following contracts:
>>>>
>>>> content-feeder.ft -> this is actually a feed2htmlSnippet contract 
>>>> but to clumpsy
>>>> content-main-lenya.ft -> obsolete
>>>> content-include-html.ft -> obsolete, can be done with genericXhtml
>>>> content-ls-contracts.ft -> never used
>>>>         
>>>
>>> Was this the contract which displayed a list of available contracts 
>>> (standard and custom) ?
>>>     
>>
>>
>> yes, but IMO that is not really suitable since the descriptions are
>> quite big.
>> Why do you ask, do you think we should keep it?
>>   
> 
> If your are talking about the content-ls-contracts, I think it was very 
> nice and useful to have an automatic generated documentation of every 
> contracts available for a project.
> It was also interesting to generate the page and include it in the 
> forrest site - in the dispatcher documentation - just like we do with 
> the DTDs.

Like Cyriaque I don't fully understand the problem that Thorsten sees. 
But I do think auto generated documentation like this is a very good 
idea. If it is replaced with something better then fine, go ahead and 
remove it, otherwise lets keep it since it is the best we have.

Ross


Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Cyriaque Dupoirieux <Cy...@pcotech.fr>.
le 21/04/2006 20:44 Thorsten Scherler a écrit :
> El vie, 21-04-2006 a las 09:55 +0200, Cyriaque Dupoirieux escribió:
>   
>> le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
>>     
>>>     [ http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 ] 
>>>
>>> Thorsten Scherler commented on FOR-797:
>>> ---------------------------------------
>>>
>>> We should remove following contracts:
>>>
>>> content-feeder.ft -> this is actually a feed2htmlSnippet contract but to clumpsy
>>> content-main-lenya.ft -> obsolete
>>> content-include-html.ft -> obsolete, can be done with genericXhtml
>>> content-ls-contracts.ft -> never used
>>>   
>>>       
>> Was this the contract which displayed a list of available contracts 
>> (standard and custom) ?
>>     
>
> yes, but IMO that is not really suitable since the descriptions are
> quite big. 
>
> Why do you ask, do you think we should keep it?
>   
If your are talking about the content-ls-contracts, I think it was very 
nice and useful to have an automatic generated documentation of every 
contracts available for a project.
It was also interesting to generate the page and include it in the 
forrest site - in the dispatcher documentation - just like we do with 
the DTDs.

I don't understand your comment "that is not really suitable since the 
descriptions are quite big." What do you mean ?
Do you mean that descriptions in existing contracts are too long because 
of the use of ls-contract ?

Salutations,
Cyriaque,
> I will not remove it for the moment.
>
> Thanks for the feedback.
>
> salu2
>   

Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Thorsten Scherler <th...@apache.org>.
El vie, 21-04-2006 a las 09:55 +0200, Cyriaque Dupoirieux escribió:
> le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
> >     [ http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 ] 
> >
> > Thorsten Scherler commented on FOR-797:
> > ---------------------------------------
> >
> > We should remove following contracts:
> >
> > content-feeder.ft -> this is actually a feed2htmlSnippet contract but to clumpsy
> > content-main-lenya.ft -> obsolete
> > content-include-html.ft -> obsolete, can be done with genericXhtml
> > content-ls-contracts.ft -> never used
> >   
> Was this the contract which displayed a list of available contracts 
> (standard and custom) ?

yes, but IMO that is not really suitable since the descriptions are
quite big. 

Why do you ask, do you think we should keep it?

I will not remove it for the moment.

Thanks for the feedback.

salu2
-- 
thorsten

"Together we stand, divided we fall!" 
Hey you (Pink Floyd)


Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins

Posted by Cyriaque Dupoirieux <Cy...@pcotech.fr>.
le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
>     [ http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442 ] 
>
> Thorsten Scherler commented on FOR-797:
> ---------------------------------------
>
> We should remove following contracts:
>
> content-feeder.ft -> this is actually a feed2htmlSnippet contract but to clumpsy
> content-main-lenya.ft -> obsolete
> content-include-html.ft -> obsolete, can be done with genericXhtml
> content-ls-contracts.ft -> never used
>   
Was this the contract which displayed a list of available contracts 
(standard and custom) ?
> siteinfo-feedback-dyn.ft -> obsolete, only slight different markup in comparison
>
> If nobody speaks up I will remove them in <24 hours.
>
>   
>> Move all v3 resources and code to the new plugins
>> -------------------------------------------------
>>
>>          Key: FOR-797
>>          URL: http://issues.apache.org/jira/browse/FOR-797
>>      Project: Forrest
>>         Type: Sub-task
>>     
>
>   
>>   Components: Dispatcher (aka views)
>>     Reporter: Thorsten Scherler
>>     
>
>   
>> move all contracts from v3 to the new plugins and finish the contracts that have not been refactored so far
>>     
>
>