docs icon indicating copy to clipboard operation
docs copied to clipboard

mc command deprecation audit

Open feorlen opened this issue 2 years ago • 3 comments

Moving deprecated mc commands to a separate section is relatively recent, there are some additional ones that should also be there. For example, mc admin top.

Identify these earlier deprecated mc commands and relocate them to the Deprecated Commands section.

feorlen avatar Jun 26 '23 16:06 feorlen

https://pypi.org/project/sphinx-reredirects/

goes into conf.py, but might be nice to yaml-ize and then convert to a dict

ravindk89 avatar Jun 26 '23 21:06 ravindk89

Findings:

These are in the list of deprecated commands, no separate page

Mainly deprecated because they were renamed

  • mc admin policy set
  • mc admin policy set
  • mc admin policy unset
  • mc admin policy update
  • mc admin replicate diff
  • mc admin replicate edit
  • mc admin replicate remove
  • mc admin bucket remote add
  • mc admin bucket remote update
  • mc admin bucket remote ls
  • mc admin bucket remote bandwidth

Not in list, doesn't have page

  • mc admin top

mc admin replicate update

This one is good, clearly marked

  • --sync

Streaming options for notify_nats configuration key deprecated, others ok

Move these to the end of the nats section

  • streaming
  • streaming_async
  • streaming_max_pub_acks_in_flight
  • streaming_cluster_id

mc admin heal deprecated options, others ok

Revisit removing these from docs in a few months https://github.com/minio/docs/issues/1029 ✅ But docs say we may still tell someone to use them? Are there replacement commands?

  • --scan
  • --recursive, r
  • --dry-run
  • --force-start, f
  • --force-stop, s
  • --remove

mc admin user svcacct add (maybe edit as well but unclear)

This is ok, clearly marked

  • --comment

feorlen avatar Oct 03 '23 18:10 feorlen

Sticking this back in to-do for the moment. Partly complete, the long tail of tidying was always going to be a background task.

feorlen avatar Nov 30 '23 01:11 feorlen