kestra-io
Guides not sufficiently explaining how to use specific plugins
Description
Some of the how-to guides on the Kestra documentation page do not provide enough guidance on how to use the specific plugins they are meant to cover. Users may find it challenging to follow along due to the lack of detailed step-by-step instructions, example workflows, or plugin configuration options.
It would be helpful to enhance these guides by including:
- Detailed step-by-step instructions on use cases,
- Example workflows with context on when to use the plugin
Specifically, the following guides could benefit from such improvements:
- https://kestra.io/docs/how-to-guides/conditional-branching
- https://kestra.io/docs/how-to-guides/loop
- https://kestra.io/docs/how-to-guides/multiplecondition-listener
### Tasks
- [x] https://kestra.io/docs/how-to-guides/conditional-branching
- [ ] https://kestra.io/docs/how-to-guides/loop
- [ ] https://kestra.io/docs/how-to-guides/multiplecondition-listener
Hello, thanks for opening this issue !
Do you have concrete examples you would like to see for these guides? I mean, there are already several blueprints or blog posts covering most of the one you mentioned.
(conditional branching -> switch and if) (loop or parallel blueprints ( multiple condition/triggers)
Hello, thank you for your response!
While I appreciate the existing blueprints and blog posts, I noticed that some of the plugin-related guides lack in-depth, step-by-step examples that could help users implement these plugins effectively. I personally don't have a specific example use case, but I believe the how-to guides could use some improvements to better guide users in utilizing the plugins.
As it stands, the guides I listed seem more like sample blueprints rather than detailed guides. Providing more explanation on the plugins, common use cases, and example workflows (existing blueprints can be linked to the conclusion of the guide for the user to learn more) would make them more accessible for users who are new to Kestra or unfamiliar with these specific plugins.
Ok thanks for your clarification ! Maybe it's a matter of improving the introductions of such pages with some example use cases (as these plugins are quite core to Kestra, they address tons of use cases) Are you open to contribute and open PR ?
Yeah, I can find some time to work on it. You can assign the issue to me.
Hello, If this issue is still active may i get assigned for the rest of the tasks?
Hello, If this issue is still active may i get assigned for the rest of the tasks?
you can work on the last one, am almost done with the second. @Dev-Aditya-More
Great, thanks for the update! I'll get started on the last task now.
Hi, I've finished adding the tutorial for the Multiple Condition Listener. Should I go ahead and open a pull request for it?
Sure! Here’s the link: (pull request) Let me know if there's a change you want me to make. Thanks for reviewing!