website icon indicating copy to clipboard operation
website copied to clipboard

Revise https://etcd.io/docs/v3.5/tutorials/how-to-create-locks/

Open celestehorgan opened this issue 1 year ago • 6 comments

This one requires @wenjiaswe or other members of etcd as there's a bit of missing explanation I can't find anywhere else in the docs :)

This issue was created in preparation for the Contributor Summit docs sprint.

File: https://github.com/etcd-io/website/blob/main/content/en/docs/v3.6/tutorials/how-to-create-locks.md

Per https://github.com/etcd-io/website/issues/765, do the following:

  • Add prerequisites (etcdctl and a currently running etcd cluster are required)
  • Define all variables and flags used in the examples in a bulleted list (in this case, --endpoints, locks)
  • Explain in a bit more detail why you might want to create a lock (i.e., what kind of client needs this?) -- this is the part you'll need an etcd maintainer for
  • Maybe: Add a section on how to release a lock, as there does not appear to currently have one and I suspect you need one ;)

When done, the document should have the following sub-sections (## H2 headings):

  • Pre-requisites
  • Creating a lock
  • Releasing a lock (new section)

celestehorgan avatar Mar 18 '24 11:03 celestehorgan

Discussed during triage. Need to copy the work from #808 and edit the same file for 3.5

moficodes avatar Sep 12 '24 18:09 moficodes

cc @samuelbartels20

jmhbnz avatar Sep 12 '24 18:09 jmhbnz

Please assign this ticket to me

samuelbartels20 avatar Sep 12 '24 18:09 samuelbartels20

/assign @samuelbartels20

jmhbnz avatar Sep 12 '24 18:09 jmhbnz