etcdserver: updated pre-vote flag description

[Fube]

Closes #17328

Please read https://github.com/etcd-io/etcd/blob/main/CONTRIBUTING.md#contribution-flow.

[k8s-ci-robot]

Hi @Fube. Thanks for your PR.

I'm waiting for a etcd-io member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

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.

[jmhbnz]

/ok-to-test

[jmhbnz]

Note that once this merges we need to raise a similar pr to update the flag description on the website: https://github.com/etcd-io/website/blob/main/content/en/docs/v3.6/op-guide/configuration.md

https://etcd.io/docs/v3.6/op-guide/configuration.

[Fube]

Note that once this merges we need to raise a similar pr to update the flag description on the website: https://github.com/etcd-io/website/blob/main/content/en/docs/v3.6/op-guide/configuration.md

https://etcd.io/docs/v3.6/op-guide/configuration.

On the subject of the website, I could not find anything on Raft itself.

Since this flag and a couple of others say "enables XYZ in Raft", maybe it'd be good to have a dedicated section on the "Learning" page: https://etcd.io/docs/v3.6/learning/

[ahrtr]

maybe it'd be good to have a dedicated section on the "Learning" page: https://etcd.io/docs/v3.6/learning/

I think users should really read https://pkg.go.dev/go.etcd.io/raft/v3#Config, or even raft paper.

[Fube]

maybe it'd be good to have a dedicated section on the "Learning" page: https://etcd.io/docs/v3.6/learning/

I think users should really read https://pkg.go.dev/go.etcd.io/raft/v3#Config, or even raft paper.

Apologies I was unclear, I meant more like link to the Raft GitHub page on the learning page of the website.

Or do you believe that is outside of the scope of the website?

[ahrtr]

Apologies I was unclear, I meant more like link to the Raft GitHub page on the learning page of the website.

Or do you believe that is outside of the scope of the website?

Thanks for the suggestion. I think it's indeed outside of the scope of etcd's doc. But I don't have very strong opinion on this.

[jmhbnz]

LGTM on green - Thanks @Fube

[serathius]

/retest