davsclaus commented on issue #673: URL: https://github.com/apache/camel-kamelets/issues/673#issuecomment-1007250024
> 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". Yeah the page already refers to the developer guide. Adding a paragraph prior pointing to the user guide is a good idea. And you are surely welcome to send a PR. > * 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. Actions was added later, we started with sink/sources. You are welcome to create a ticket so the task is not forgotten. > * 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. David, that is a harsh statement to call it "toys" - Kamelets are in heavy development and they are on 0.x release (not reached a 1.0 GA yet). Sours and Sinks are the most important goals of Kamelets, to make it even easier to connect to/from systems. Take a moment to read also some of the blogs about Kamelets that we have published, such as https://camel.apache.org/blog/2021/11/low-code-camel/ https://camel.apache.org/blog/2021/02/Kamelet-Catalog/ > > 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. > David, this is again a harsh statement about "violation of XXX". As you have learned now there is a reason for this as explained by Luca. > 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. Okay but you did not only do that .. you also made acquisitions and harsh remarks about the camel-kamelets project, which made this ticket worse and causing frustrations among the maintainers of this project. -- 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: commits-unsubscr...@camel.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
