Reinhard Haller pisze:
Hi,

Jeroen Reijn schrieb:
Hi Derek,

as far as I know (I have not used the cinclude transformer in more then a year) you will only have to change the way you feed parameters to the transformer from your xsl or xml. As i can remember the include transformer does not have a containing parameters element. Everything else should be the same as far as I can remember.


don't forget:: the problem is not whether a specific transformer is deprecated or not. It's the complete lack of any documentation about any transformer, generator, serializer and their parameters, behaviour, concept if you are unwilling to read the Java implementation documentation. If the following statement is all we can expect as documentation for the core-modules/sitemap-components:

"Implementation of basic actions, modules, some sources, matchers and selectors that are used in most Cocoon webapps"

then i can't see any reason to migrate from a bad documentation/user experience (2.1) to a even worse one (2.2).

Reinhard, have you seen this document:
http://cocoon.apache.org/2.2/1347_1_1.html

Granted, this is all confusing because it can be found by clicking at "Cocoon 2.2" (in the top menu) and then in left navigation you must scroll down to bottom in order to find it. I think this should be moved to sitemap-components. I guess that is five minutes to do it (not now though, it's already late here).

I agree that our documentation can be in inconsistent state. The best excuse for that I can think of is that we have performed major change in the infrastructure behind our docs. I can assure you that it was worth it even if not everything is ok now. I think that the ball is on your side dear users - just find all annoying issues with documentation, report them (the recommended way is through JIRA[1] so reports don't get lost) and we'll take care of them. Usually, most of issues that has been reported lately were rather trivial to fix, taking less than 20 minutes to fix. Given that, there is a hope that most of them can be fixed quickly.

I think it's your time to have hands dirty...

PS. Even I'm short on time these days (you probably noticed my decreased activity) I'm constantly working on some demo app presenting new features of 2.2 in action. I'm already planning to tag a first release of this gem so you should see a little announcement shortly. Those more curious will probably have no problem with finding repository on the internet...

[1] http://cocoon.apache.org/1275_1_1.html

--
Grzegorz Kossakowski

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to