[java-generator] Improve the docs to include examples of the options

[andreaTP]

Is your enhancement related to a problem? Please describe

Currently, the docs are listing the available options for the plugins and the CLI, but there are no examples of "how to use them" and the expected output.

Describe the solution you'd like

We should describe the available options and include snippets of the usage and how it affects the generation.

Describe alternatives you've considered

No response

Additional context

No response

[g1rjeevan]

/assign

[shubhamvrs]

/assign

[andreaTP]

Hi @shubhamvrs and thanks for your interest!

To complete this task we do expect a PR expanding this section of the current docs:
https://github.com/fabric8io/kubernetes-client/blob/main/doc/java-generation-from-CRD.md#usage

Would you be able to provide it?

[shubhamvrs]

i tried my best sir but im unable to create it actually im new to github thatswhy !

[rohanKanojia]

@shubhamvrs : Could you please elaborate? What problem are you facing?

[shubhamvrs]

@rohanKanojia im not able to provide a PR expanding this section: ( https://github.com/fabric8io/kubernetes-client/blob/main/doc/java-generation-from-CRD.md#) usage of the current docs that i have created previously

[rohanKanojia]

@shubhamvrs : Do you mean you don't have enough knowledge about java generator to improve existing documentation?

[shubhamvrs]

im unable to create new file in given format with given path in new pull request

[rohanKanojia]

@shubhamvrs : Why is that so? Are you getting some error?

[shubhamvrs]

@rohanKanojia its just im unable to create a file on given format. I have the doc but file needs to be converted in given format !

[rohanKanojia]

I'm not able to understand what you're saying. Which document are you talking about?

[shubhamvrs]

@rohanKanojia

[rohanKanojia]

@shubhamvrs : This doesn't look correct to me. You need to add examples of options of CLI and maven plugin. Users won't be using JavaGenerator class directly. You need to add example output as well.

I'm afraid working with this issue requires knowledge about Kubernetes, Custom Resources, and maven. I think it is not a good fit for your skills.

[shubhamvrs]

@rohanKanojia okayy

[rohanKanojia]

@shubhamvrs : Please don't get discouraged by my comment. You're still welcome to contribute. But perhaps you should start with something really simple as a first contribution (maybe correcting grammar mistakes, fixing/improving tests, etc)

[shubhamvrs]

@rohanKanojia sure sir i will😊

[AlishRani]

/assign

[heralgi]

/assign

[manusa]

Note, there is no bot controlling the issue assignment so `/assign' won't work.

If you're willing to work on the issue, just ask so politely 🙂

Also, make sure to understand what's requested and how to proceed. We might assist you a little, but we do expect a minimum knowledge of what you're handling here.

[Mandeep56Singh]

i want to contribute to this repo , i only know java .
Which other things do i need to know in order to contribute ( good contribution)
Please help, I am beginner in open source contribution

[Mandeep56Singh]

I will learn whatever needed to shut down this issue .
I just need your help .

[andreaTP]

@Mandeep56Singh this is the expectation:
#5285 (comment)

Let us know if you have further questions.

[Mandeep56Singh]

@andreaTP could you please tell
what knowledge should I have to work on this issue ?
I only know java ( mostly for algorithms)

[andreaTP]

#5285 (comment)

[stale]

This issue has been automatically marked as stale because it has not had any activity since 90 days. It will be closed if no further activity occurs within 7 days. Thank you for your contributions!

[stale]

This issue has been automatically marked as stale because it has not had any activity since 90 days. It will be closed if no further activity occurs within 7 days. Thank you for your contributions!