Replace quote blocks with alerts for callouts througout the docs

[jberkus]

Per #1046, anywhere we have an attention-grabbing callout in the docs, we should use an alert instead of a blockquote. At some point, we should audit the whole docs base to clean this up.

[ntdkhiem]

Hi everyone! I'm interested in tackling this issue. I've been reading up the etcd documentation and would love to make this my first contribution. Could you please assign this to me?

Here are places that could use a warning/note/tip alert instead of a blockquote or a normal text:

https://etcd.io/docs/v3.6/op-guide/security/#:~:text=Important%3A%20Before%20starting%20work%20on%20converting%20the%20cluster%20to%20TLS%2C%20please%20make%20a%20backup%20of%20the%20etcd%20database.%20Important%3A%20Before%20restarting%20any%20etcd%20members%2C%20you%20must%20first%20add%20the%20TLS%20certificates%20and%20configuration%20to%20each%20etcd%20node.

https://etcd.io/docs/v3.6/op-guide/security/#:~:text=Save%20the%20member%20IDs%20and%20corresponding%20IP%20addresses%20%E2%80%94%20you%E2%80%99ll%20need%20them%20to%20update%20peer%20URLs.

https://etcd.io/docs/v3.6/install/#:~:text=Disclaimer%3A%20etcd%20installations%20through%20OS%20package%20managers%20can%20deliver%20outdated%20versions%20since%20they%20are%20not%20being%20automatically%20maintained%20nor%20officially%20supported%20by%20etcd%20project.%20Therefore%20use%20OS%20packages%20with%20caution.

https://etcd.io/docs/v3.6/feature-gates/#:~:text=Note%3A%20Please%20do%20try%20Beta%20features%20and%20give%20feedback%20on%20them!%20After%20they%20exit%20beta%2C%20it%20may%20not%20be%20practical%20for%20us%20to%20make%20more%20changes.

https://etcd.io/docs/v3.6/metrics/#:~:text=Note%3A%20The%20process%20metrics%2C%20such%20as%20process_open_fds%20and%20process_max_fds%2C%20are%20not%20supported%20on%20Darwin%20(macOS)%20systems%20at%20this%20time.

https://etcd.io/docs/v3.6/dev-internal/discovery_protocol/#:~:text=Note%20that%20this%20document%20is%20only%20for%20v3%20discovery.%20Check%20previous%20document%20for%20more%20details%20on%20v2%20discovery.

https://etcd.io/docs/v3.6/dev-guide/interacting_v3/#:~:text=Note%20that%20any%20key%20that%20was%20created%20using%20the%20v2%20API%20will%20not%20be%20able%20to%20be%20queried%20via%20the%20v3%20API.%20A%20v3%20API%20etcdctl%20get%20of%20a%20v2%20key%20will%20exit%20with%200%20and%20no%20key%20data%2C%20this%20is%20the%20expected%20behaviour.

https://etcd.io/docs/v3.6/dev-guide/grpc_naming/#:~:text=Note%20that%20this%20feature%20is%20experimental%20because%20it%20depends%20on%20the%20google.golang.org/grpc/resolver%20package%2C%20which%20is%20still%20experimental%20in%20grpc%2Dgo.

https://etcd.io/docs/v3.6/op-guide/security/#:~:text=OSX%2010.9%2B%20Users,let%20us%20know.

https://etcd.io/docs/v3.6/op-guide/security/#:~:text=Note%20that%20etcd,to%20any%20clients.

https://etcd.io/docs/v3.6/op-guide/security/#:~:text=NOTE%3A%20When%20you%20specify%20ClientAutoTLS%20and%20PeerAutoTLS%2C%20the%20validity%20period%20of%20the%20client%20certificate%20and%20peer%20certificate%20automatically%20generated%20by%20etcd%20is%20only%201%20year.%20You%20can%20specify%20the%20%2D%2Dself%2Dsigned%2Dcert%2Dvalidity%20flag%20to%20set%20the%20validity%20period%20of%20the%20certificate%20in%20years.

https://etcd.io/docs/v3.6/op-guide/clustering/#:~:text=Each%20member%20must%20have%20a%20different%20name%20flag%20specified.%20Hostname%20or%20machine%2Did%20can%20be%20a%20good%20choice.%20Or%20discovery%20will%20fail%20due%20to%20duplicated%20name.

https://etcd.io/docs/v3.6/op-guide/clustering/#:~:text=Each%20member%20must%20have%20a%20different%20name%20flag%20specified%20or%20else%20discovery%20will%20fail%20due%20to%20duplicated%20names.%20Hostname%20or%20machine%2Did%20can%20be%20a%20good%20choice.

https://etcd.io/docs/v3.6/op-guide/maintenance/#:~:text=Note%20that%20defragmentation,all%20cluster%20members.

https://etcd.io/docs/v3.6/op-guide/maintenance/#:~:text=NOTE%3A%20it,transaction%20from%20proceeding.

https://etcd.io/docs/v3.6/benchmarks/etcd-3-watch-memory-benchmark/#:~:text=NOTE%3A%20The%20watch%20features%20are%20under%20active%20development%2C%20and%20their%20memory%20usage%20may%20change%20as%20that%20development%20progresses.%20We%20do%20not%20expect%20it%20to%20significantly%20increase%20beyond%20the%20figures%20stated%20below.

https://etcd.io/docs/v3.6/downgrades/downgrade_3_5/#:~:text=NOTE%3A%20If%20your%20cluster%20enables%20auth%2C%20rolling%20downgrade%20from%203.5%20isn%E2%80%99t%20supported%20because%203.5%20changes%20a%20format%20of%20WAL%20entries%20related%20to%20auth.%20You%20can%20follow%20the%20authentification%20instructions%20to%20disable%20auth%2C%20and%20delete%20all%20users%20first.

https://etcd.io/docs/v3.6/downgrades/downgrade_3_6/#:~:text=NOTE%3A%20Once%20downgrade%20is%20enabled%2C%20the%20cluster%20will%20remain%20operating%20with%20v3.5%20protocol%20even%20if%20all%20the%20servers%20are%20still%20running%20the%20v3.6%20binary%2C%20unless%20the%20downgrade%20is%20canceled%20with%20etcdctl%20downgrade%20cancel

https://etcd.io/docs/v3.6/downgrades/downgrade_3_6/#:~:text=NOTE%3A%20You%20will%20see%20the%20DOWNGRADE%20ENABLED%20is%20false%20for%20the%20v3.5%20server%2C%20because%20the%20downgrade%20info%20is%20not%20implemented%20in%20v3.5%20status%20endpoint%2C%20downgrade%20is%20still%20enabled%20for%20the%20cluster%20at%20this%20point.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_1/#:~:text=NOTE%3A%20When,contains%20v3%20data.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_5/#:~:text=NOTE%3A%20When,contains%20v3%20data.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_4/#:~:text=NOTE%3A%20When,contains%20v3%20data.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_3/#:~:text=NOTE%3A%20When,contains%20v3%20data.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_3/#:~:text=Note%20that%20this%20field%20has%20been%20renamed%20to%20embed.Config.LogOutputs%20in%20%5B%5Dstring%20type%20in%20v3.4.%20Please%20see%20v3.4%20upgrade%20guide%20for%20more%20details.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_3/#:~:text=Note%20that%20embed.Config.SetupLogging%20method%20has%20been%20deprecated%20in%20v3.4.%20Please%20see%20v3.4%20upgrade%20guide%20for%20more%20details.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_2/#:~:text=NOTE%3A%20When,contains%20v3%20data.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_0/#:~:text=NOTE%3A%20When,contains%20v3%20data.

Here are places that maybe could use a warning/note/tip alert instead of a blockquote or a normal text:

https://etcd.io/docs/v3.6/install/#:~:text=Although%20installing%20etcd%20through%20many%20major%20Linux%20distributions%E2%80%99%20official%20repositories%20and%20package%20managers%20is%20possible%2C%20the%20published%20versions%20can%20be%20significantly%20outdated.%20So%2C%20installing%20this%20way%20is%20strongly%20discouraged.

https://etcd.io/docs/v3.6/faq/#:~:text=Note%20that%20performance%20is%20intrinsically%20workload%20dependent%3B%20please%20test%20before%20production%20deployment.

https://etcd.io/docs/v3.6/dev-guide/interacting_v3/#:~:text=Note%3A%20The%20lease%20id%201234abcd%20in%20the%20above%20command%20refers%20to%20id%20returned%20on%20creating%20the%20lease%20of%2010s.%20This%20id%20can%20then%20be%20attached%20to%20the%20key.

https://etcd.io/docs/v3.6/dev-guide/interacting_v3/#:~:text=Note%20that%20foo3%20is%20excluded%20since%20the%20range%20is%20over%20the%20half%2Dopen%20interval%20%5Bfoo%2C%20foo3)%2C%20excluding%20foo3.

https://etcd.io/docs/v3.6/dev-guide/interacting_v3/#:~:text=Note%3A%20The%20revision,etcd%20server%20node.

https://etcd.io/docs/v3.6/dev-guide/interacting_v3/#:~:text=Note%3A%20The%20current%20revision%20of%20etcd%20server%20can%20be%20found%20using%20get%20command%20on%20any%20key%20(existent%20or%20non%2Dexistent)%20in%20json%20format.

https://etcd.io/docs/v3.6/dev-guide/api_reference_v3/#:~:text=DowngradeVersionTestRequest%20is%20used%20for%20test%20only.

https://etcd.io/docs/v3.6/op-guide/clustering/#:~:text=Note%20that%20the%20URLs%20specified%20in%20initial%2Dcluster%20are%20the%20advertised%20peer%20URLs%2C%20i.e.%20they%20should%20match%20the%20value%20of%20initial%2Dadvertise%2Dpeer%2Durls%20on%20the%20respective%20nodes.

https://etcd.io/docs/v3.6/op-guide/recovery/#:~:text=Note%20that%20taking%20the%20snapshot%20from%20the%20member/snap/db%20file%20might%20lose%20data%20that%20has%20not%20been%20written%20yet%2C%20but%20is%20included%20in%20the%20wal%20(write%2Dahead%2Dlog)%20folder.

https://etcd.io/docs/v3.6/downgrades/downgrade_3_5/#:~:text=NOTE%20The%20diff%20is%20based%20on%20version%203.5.14%20and%20v.3.4.33.%20The%20actual%20diff%20would%20be%20dependent%20on%20your%20patch%20version%2C%20check%20with%20diff%20%3C(etcd%2D3.5/bin/etcd%20%2Dh%20%7C%20grep%20%5C%5C%2D%5C%5C%2D)%20%3C(etcd%2D3.4/bin/etcd%20%2Dh%20%7C%20grep%20%5C%5C%2D%5C%5C%2D)%20first.

https://etcd.io/docs/v3.6/downgrades/downgrade_3_5/#:~:text=Note%3A%20If%20the%20cluster%20only%20has%20v3%20data%20and%20no%20v2%20data%2C%20it%20is%20not%20subject%20to%20this%20limitation.

https://etcd.io/docs/v3.6/downgrades/downgrade_3_6/#:~:text=NOTE%3A%20The%20diff%20is%20based%20on%20version%20v3.6.0%20and%20v.3.5.18.%20The%20actual%20diff%20would%20be%20dependent%20on%20your%20patch%20version%2C%20check%20with%20diff%20%3C(etcd%2D3.6/bin/etcd%20%2Dh%20%7C%20grep%20%5C%5C%2D%5C%5C%2D)%20%3C(etcd%2D3.5/bin/etcd%20%2Dh%20%7C%20grep%20%5C%5C%2D%5C%5C%2D)%20first.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_1/#:~:text=Note%3A%20If%20the%20cluster%20only%20has%20v3%20data%20and%20no%20v2%20data%2C%20it%20is%20not%20subject%20to%20this%20limitation.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_5/#:~:text=Note%3A%20If%20the%20cluster%20only%20has%20v3%20data%20and%20no%20v2%20data%2C%20it%20is%20not%20subject%20to%20this%20limitation.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_4/#:~:text=%2Betcd_mvcc_put_total-,Note%20that%20etcd_debugging_*%20namespace%20metrics%20have%20been%20marked%20as%20experimental.%20As%20we%20improve%20monitoring%20guide%2C%20we%20may%20promote%20more%20metrics.,-Deprecating%20etcd_debugging_mvcc_delete_total%20Prometheus

https://etcd.io/docs/v3.6/upgrades/upgrade_3_4/#:~:text=%2Betcd_mvcc_delete_total-,Note%20that%20etcd_debugging_*%20namespace%20metrics%20have%20been%20marked%20as%20experimental.%20As%20we%20improve%20monitoring%20guide%2C%20we%20may%20promote%20more%20metrics.,-Deprecating%20etcd_debugging_mvcc_txn_total%20Prometheus

https://etcd.io/docs/v3.6/upgrades/upgrade_3_4/#:~:text=Note%3A%20If%20the%20cluster%20only%20has%20v3%20data%20and%20no%20v2%20data%2C%20it%20is%20not%20subject%20to%20this%20limitation.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_3/#:~:text=Note%20that%20in%20v3.3.0%2Drc.0%2C%20v3.3.0%2Drc.1%2C%20and%20v3.3.0%2Drc.2%2C%20etcdhttp.Health%20has%20boolean%20type%20%22health%22%20and%20%22errors%22%20fields.%20For%20backward%20compatibilities%2C%20we%20reverted%20%22health%22%20field%20to%20string%20type%20and%20removed%20%22errors%22%20field.%20Further%20health%20information%20will%20be%20provided%20in%20separate%20APIs.

https://etcd.io/docs/v3.6/upgrades/upgrade_3_0/#:~:text=To%20upgrade%20an%20existing%20etcd%20deployment%20to%203.0%2C%20the%20running%20cluster%20must%20be%202.3%20or%20greater.%20If%20it%E2%80%99s%20before%202.3%2C%20please%20upgrade%20to%202.3%20before%20upgrading%20to%203.0.

Out-of-topic:
I think this block of text is supposed to be broken down into a list of three items.
https://etcd.io/docs/v3.6/dev-guide/api_reference_v3/#:~:text=From%20google%20paxosdb,evaluates%20to%20false.

[ronaldngounou]

/assign ntdkhiem

[ronaldngounou]

Feel free to work on it, happy to help review.