Thank you for your input! Some excellent comments have been made and all are
noted.
So far, the poll results show that there is no unanimity (see below). I
think that it would be pretty unscientific to reach any firm conclusions
based on such a small sample, but I think that some "trends" can be
established.
First, I think it is clear, not only from this poll but from the many
messages that have been posted lately, that the general opinion is that work
needs to be done on the user docs to be more user-centric, use case
oriented, and less confusing.
However, there is some fear (for lack of a better word) that we will be
taking freedom away from more experienced developers who may resent being
forced down a certain path. There is also the concern that whatever we cite
as the "preferred" approach may not be the best choice for a particular use
case, or that the "best practice" may change.
Generally, based on your comments, it appears that a good approach may be to
choose a "currently preferred approach". This recognises that what is often
called "best practices" may change over time. This makes sense to me. So the
CPA method allows for future changes (without loss of face), while still
allowing us to focus on one particular approach for beginners.
Other than the CPA, we would show other options. For example, if a newbie
were reading up on JXTemplates, rather than saying that you can use Jexl or
JXPath, we would choose our CPA (for example, JXPath), but have a link to a
homologous page that explains the same things, but for Jexl. This would
reduce one more variable, and thus one more possible source of delay or
confusion to a newbie. So new users will be able to get up and running much
faster, and once they have more experience, will be able to go over the
alternative approaches.
This seems to me a good compromise and, hopefully, a means of reaching
consenus.
Questions? Comments? Insults?
It's not too late to chime in if you still want to vote or have other
comments to add. The above is not a conclusion, just a proposition.
***********************************************************
[ ] A. I think that we should show users the "best" way
to get up and running with Cocoon.
[ ] B. I think that we should show users all the options
possible and let them decide the best approach.
[ ] C. Yeah, whatever. Either way is good for me.
Peace, man!
Poll results so far:
A. - 6
B. - 3
C. - 0
A
Dave L.
Derek H.
Tim L.
JDD
Nacho J.
Joel M.
B
Ugo C.
Stavros K.
Ralph G.
***********************************************************
Dave L.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
