docs: rename reference docs to "object_action"

[dvdksn]

• carries, closes [WIP] reorganise reference docs #2389
• relates to Canonical CLI / moby 25 docs#19045

- What I did

Making sure there's only 1 canonical markdown file for each command. In the documentation repository, I'll add redirects for each command, and update titles to mention both variants.

e.g., redirect docker build to docker image build

- How I did it

- How to verify it

- Description for the changelog

- A picture of a cute animal (not mandatory but encouraged)

[codecov-commenter]

Codecov Report

Merging #4755 (b35361e) into master (077d07c) will increase coverage by 59.20%.
Report is 4 commits behind head on master.
The diff coverage is n/a.

Additional details and impacted files

@@             Coverage Diff             @@
##           master    #4755       +/-   ##
===========================================
+ Coverage        0   59.20%   +59.20%     
===========================================
  Files           0      286      +286     
  Lines           0    24778    +24778     
===========================================
+ Hits            0    14669    +14669     
- Misses          0     9221     +9221     
- Partials        0      888      +888     

[thaJeztah]

I'll give it a try if we can make the changes show up as "move" in stead of "delete -> new file", so that (with a bit of luck) we can better preserve history.

So don't merge yet (but thanks so much for working on this!! changes look good)

[dvdksn]

hi @thaJeztah I changed the approach here and it should preserve history better now:

1. In the first commit I deleted the stub files which didn't have any content.
2. In the second commit I git mv the "golden" files and renamed them to use the canonical name.

If you check the diff for the 2nd commit it looks OK a6774de

[thaJeztah]

Ah, nice! Yes this looks good! Do we need a third commit to add stubs for the non-canonical commands? (which I think can be generated?) or can we do without? (from the "docs" side, I don't think we currently use those)

[dvdksn]

Hmm, yeah we don't need them at all in the docs, but regenerating mddocs would recreate those stubs, so let me commit the "empty" generated stubs just so they're there and we don't cause any trouble for someone the next time they want to regenerate markdown.

[thaJeztah]

LGTM

@crazy-max PTAL

[dvdksn]

snuck in an extra commit fixing a link to an anchor that doesn't exist and isn't needed 🙈

[sam-thibault]

lgtm

[thaJeztah]

Thanks! Let's bring this one in 👍

[thaJeztah]

We may have to check if there's old docs PRs that now fail, and need a carry (or "close"). If you have some time (not urgent) to check, that'd be great, @dvdksn