bug#31311: 27.0; doc of `pcase'

[Drew Adams]

> This bug report pointed out a lot of things that 
> could be improved in the pcase documentation.

Of course.  Glad you recognize that there are so
many things wrong with that doc - lots of things
that _need_ improving.

And you're welcome for thanking me for having
reported so many of them specifically.

> The documentation was largely rewritten a bit
> later, and skimming this thread, it seems like
> the major objections were all handled,

The point in specifying particular problems, as
opposed to just tossing out "major objections",
is to help get the doc fixed in those many ways.

> so I'm closing this bug report.

Does the doc now respond to all of the cited needs
and deficiencies?  If not, then the bug isn't fixed.

If you don't keep it open so those can be fixed,
then ... "wont fix".

> If there are any remaining issues, opening a new
> bug report for those issues would be the way forward.

Then do that.  If the bug isn't fixed then it
isn't fixed.  A new bug specifying what remains
to be fixed is a fine idea.  Please go for it.
The way forward isn't just to ignore them and
call the bug fixed.