Docs: add note about management commands targeting a manager

[thaJeztah]

Alternative for #1578

closes #1578 already merged

[thaJeztah]

Wasn't sure how to deal with k8s as an orchestrator here; this command can be run both on Swarm or Kubernetes, so we may need a different description to either make it generic enough to fit both use-cases, or extend the description to explicitly call out both use-cases

[silvin-lubecki]

Maybe add a something like: **Note**:If you use swarm as an orchestrator, this is a cluster management command... ?

[thaJeztah]

This is a quick approach for this, but I think we can add annotations for this, so that;

• it can be used to automatically show/hide commands if the node is not a manager
• it can be included in the generated YAML docs, so that we can add this information automatically when generating the documentation; similar to the API-version and Orchestrator annotations;

[codecov-io]

Codecov Report

❗ No coverage uploaded for pull request base (master@0fd5c16). Click here to learn what that means.
The diff coverage is n/a.

@@            Coverage Diff            @@
##             master    #1590   +/-   ##
=========================================
  Coverage          ?   55.25%           
=========================================
  Files             ?      289           
  Lines             ?    19395           
  Branches          ?        0           
=========================================
  Hits              ?    10716           
  Misses            ?     7983           
  Partials          ?      696

[thaJeztah]

@ahh-docker @vdemeester

[vdemeester]

SGTM 👼

[ahh-docker]

LGTM

[SvenDowideit]

mmm, LGTM - though i'm saddened that I didn't build something to let you transclude the note from one place :D

[thaJeztah]

though i'm saddened that I didn't build something to let you transclude the note from one place :D

Yeah, the docs switched to Jekyll at some point, so perhaps it could be handled there, but I didn't want to jinx it 😂

Let me do a small update to address the "kubernetes as stack orchestrator" situation;
#1590 (comment)

[thaJeztah]

@silvin-lubecki slightly changed the wording for docker stack commands, to explicitly mention that a manager node must be targeted when using "swarm" as orchestrator.

[silvin-lubecki]

LGTM