README_DOCS.rst: wordsmith some of the commentary
commit78ed5a49df89b73e50ee8c51de95f2b9226a5768
authorKyle J. McKay <mackyle@gmail.com>
Thu, 9 Sep 2021 03:17:07 +0000 (8 20:17 -0700)
committerKyle J. McKay <mackyle@gmail.com>
Thu, 9 Sep 2021 03:17:07 +0000 (8 20:17 -0700)
tree130d2353eeb898f04dcb95df81c7dbd62b555e25
parent54c563f8c556604519181815baf36989ae0b92b5
README_DOCS.rst: wordsmith some of the commentary

It's not relevent _why_ Git fails (and, in this case, the analysis
either was wrong or later became wrong); what's relevant is that
Git has a major FAIL when dealing with reflogs of annotated/signed
tags.

It appears that the current excuse is that `git reflog show` being
just an alias for `git log -g --abbrev-commit --pretty=oneline` --
according to `git help reflog` -- means that anything other than a
commit cannot be handled since `git log` only deals with commits.

In any case the *WHY* is not important here, just the *FAIL* bit.
Take out the analysis (which might become incorrect in the future)
and just leave the relevant stuff.  Do add a mention of
`git reflog show` though as not everyone may be aware that it's
just an alias for `git log -g`.

Signed-off-by: Kyle J. McKay <mackyle@gmail.com>
README_DOCS.rst