djencks commented on issue #673:
URL: https://github.com/apache/camel-kamelets/issues/673#issuecomment-1006402456


   OK, so I read 
https://camel.apache.org/camel-k/next/kamelets/kamelets-user.html and have 
perhaps some clues and some questions.
   - I think it would be helpful to directly link to the user guide from the 
kamelets catalog index page, something like "consult the user guide for 
information about how to use these".
   - AFAICT the user guide doesn't mention actions.  IIUC these have both a 
source and sink, so you can string them together.  An example in the user guide 
would be great.
   - The kamelets in the catalog have what appear to be toy sources and sinks.  
Is their function for testing?  Mentioning this in the user guide might be 
helpful.
   
   I also think the description of extract field action is pretty close to 
useless.... "Extract a field from the body".... and then what?  Trying to find 
the source code behind this one, it appears to be in `  - 
"github:apache.camel-kamelets:camel-kamelets-utils:main-SNAPSHOT"` which I 
can't locate and which by the "main-SNAPSHOT" makes me wonder if it violates 
the Apache policy against directing people to unreleased code.
   
   Personally, when someone says the docs are useless, I tend to interpret it 
as "I'm so frustrated I can't figure out how to do what I want!!!" and try to 
respond to that.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to