Re: [PATCH v2] Revert "doc: move git-cherry to plumbing"

> kristofferhaugsbakk@fastmail.com writes:
>> This command might only be considered plumbing by way of the plumbing
>> contract that says that plumbing commands have stable output.  But
>> hopefully listing this command as Porcelain does not give the impression
>> that the output is not stable.  Output stability was in any case not the
>> motivation for moving this command to plumbing.
>
> I do not follow the above reasoning at all.
>
> It is not like it is a crime to intarctively make use of a plumbing
> command, or we intentionally try to hide plumbing command from them
> by making it deliberately less accessible.  "git cat-file commit X"
> may be handier than "git show -s X" for some people and that is not
> to be frowned upon.
>
> And what you call "might only be" is really the crucial thing to
> consider.  If we want to keep a tool's output stable and machine
> readable, we need to mark it as "meant for Porcelain writers", and
> classifying the tool as plumbing is a pretty much established way to
> do so.