Add user guide

[alculquicondor]

/kind feature
/size M

Something more comprehensive that the existing README. Some of the use cases in bit.ly/kueue-apis can be dumped into samples/guides.

If possible, generate some documentation out of the APIs, similar to https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/

Contents (not necessarily each one will be a page, but they could be sections on existing pages).

• Single CQ setup
• Multiple flavors
• Multiple CQ setup (cohorts)
• Namespace selectors
• Cohorts
• Running a Job
• Configuring RBAC
• Monitoring usage (kubectl describe)

[ArangoGutierrez]

Could we use github pages? or just a folder with markdown is ok for now?
GitHub pages is easy to manage using prow automation

[ArangoGutierrez]

/kind documentation
/good-first-issue

[k8s-ci-robot]

@ArangoGutierrez:
This request has been marked as suitable for new contributors.

Guidelines

Please ensure that the issue body includes answers to the following questions:

• Why are we solving this issue?
• To address this issue, are there any code changes? If there are code changes, what needs to be done in the code and what places can the assignee treat as reference points?
• Does this issue have zero to low barrier of entry?
• How can the assignee reach out to you for help?

For more details on the requirements of such an issue, please see here and ensure that they are met.

If this request no longer meets these requirements, the label can be removed
by commenting with the /remove-good-first-issue command.

In response to this:

/kind documentation
/good-first-issue

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[alculquicondor]

We can probably start with markdown and move it to github pages when there is some useful content :)

[alculquicondor]

I'll start this

/assign

[alculquicondor]

I just added in the description a list of things I would like to cover. Anything else?

[ArangoGutierrez]

for a v0.0.1 , we are ok i Think

[ahg-g]

one more thing to add to CQ concept is queueing strategy