kube-scheduler-simulator icon indicating copy to clipboard operation
kube-scheduler-simulator copied to clipboard

Improve documentation about environment variables being used

Open pravarag opened this issue 2 years ago • 17 comments

What type of PR is this?

/kind documentation

What this PR does / why we need it:

As part of this PR, we are adding documentation for environment variables that are used to configure kube-scheduler-simulator

Which issue(s) this PR fixes:

Fixes #106

Special notes for your reviewer:

/label tide/merge-method-squash

pravarag avatar Mar 27 '22 07:03 pravarag

Skipping CI for Draft Pull Request. If you want CI signal for your change, please convert it to an actual PR. You can still manually trigger a test run with /test all

k8s-ci-robot avatar Mar 27 '22 07:03 k8s-ci-robot

Thanks for opening the PR. Could you move this doc to README so that users don't miss it?

Sure, do you want me to put the entire contents in README itself or provide a link to this new document in the README file?

pravarag avatar Mar 29 '22 01:03 pravarag

provide a link to this new document in the README file?

👍 nice idea. just adding a link to README seems to be fine.

sanposhiho avatar Apr 05 '22 15:04 sanposhiho

@pravarag Could you add the description about KUBE_SCHEDULER_CONFIG_PATH on docs/env-variables.md as well? https://github.com/kubernetes-sigs/kube-scheduler-simulator/pull/131/files#r857065848

We already have the doc about this here: https://github.com/kubernetes-sigs/kube-scheduler-simulator/blob/master/README.md?plain=1#L32 But, I think it's better to move this to docs/env-variables.md.

sanposhiho avatar Apr 24 '22 04:04 sanposhiho

And could you rebase and open this PR?

sanposhiho avatar Apr 24 '22 05:04 sanposhiho

/retitle Improve documentation about environment variables being used

sanposhiho avatar May 09 '22 16:05 sanposhiho

@sanposhiho I've updated the PR with some new env variables, kindly take a look and let me know for any changes/updates required.

pravarag avatar May 31 '22 17:05 pravarag

@pravarag Please add link for docs/env-variables.md at somewhere on README.md.

sanposhiho avatar Jun 01 '22 05:06 sanposhiho

@pravarag Please add link for docs/env-variables.md at somewhere on README.md.

Done with the latest push.

pravarag avatar Jun 03 '22 03:06 pravarag

Thank you! LGTM about the perspective of the #131 .

ping @sanposhiho

/lgtm

196Ikuchil avatar Jun 26 '22 01:06 196Ikuchil

And please add the description about the default value for each variable. And if the environment variable is required one, you may want to add the note about it.

sanposhiho avatar Jun 29 '22 04:06 sanposhiho

the description for EXTERNAL_IMPORT_ENABLED is missing

Thanks for a detailed review above. I've added the mentioned variable and also added (required) in front of mandatory variables. Let me know if this looks good or any other changes are required. @sanposhiho @196Ikuchil

pravarag avatar Jul 11 '22 17:07 pravarag

@sanposhiho @196Ikuchil let me know if any further changes are required for this PR :)

pravarag avatar Aug 03 '22 15:08 pravarag

Ahhh, sorry, I missed the notification. I will check it this weekend.

sanposhiho avatar Aug 04 '22 15:08 sanposhiho

Sorry for too late reviews bow Btw, please feel free to ping me on Kubernetes slack. (I often miss the notification from GitHub because I receive them a lot every day. sweat )

Thanks for the review @sanposhiho , I've updated the code as per the suggested changes :)

pravarag avatar Aug 09 '22 07:08 pravarag

Apologies for the delayed response, I've updated as per review comments @sanposhiho @196Ikuchil .

pravarag avatar Sep 21 '22 13:09 pravarag

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: pravarag, sanposhiho

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment Approvers can cancel approval by writing /approve cancel in a comment

k8s-ci-robot avatar Sep 24 '22 04:09 k8s-ci-robot

Thank you for a very very long time! /lgtm

196Ikuchil avatar Sep 24 '22 07:09 196Ikuchil