Add docstrings to matcher-combinators.test declarations

[philomates]

I had to change the declare forms in matcher-combinators.test to defns so that the docstring would be picked up by LSP. Just adding :doc meta to the declare, like the following, doesn't seem to get picked up by the clojure LSP as far as I can tell

(require '[matcher-combinators.test :refer [match? thrown-match?]])
(declare ^{:arglists '([matcher actual]) :doc "some docstring"} match?)
(:doc (meta #'match?))

[teodorlu]

Could also be helpful for users to include :deprecated "deprecated-version" metadata:

Suggested change

	(defn match-with?
	"DEPRECATED: Use (match? (matcher-combinators.matchers/match-with <type->matcher> <expected>) <actual>) instead."
	[type->matcher matcher actual]
	(throw (#?(:cljs js/Error. :clj AssertionError.)
	"Should only be invoked within a `clojure.test/is` form")))
	(defn match-with?
	"DEPRECATED: Use (match? (matcher-combinators.matchers/match-with <type->matcher> <expected>) <actual>) instead."
	{:deprecated "3.0.0"}
	[type->matcher matcher actual]
	(throw (#?(:cljs js/Error. :clj AssertionError.)
	"Should only be invoked within a `clojure.test/is` form")))

This will show up in most editors that rely on clojure-lsp. My Emacs the referenced var with strikethough, and deprecated version below:

[NoahTheDuke]

Looks like this is a redo of my PR #207, which i couldn't ever get to work. I'll close that one if you can get the test suite to pass.

[teodorlu]

Thank you! 🙏

[philomates]

released as 3.10.1

[NoahTheDuke]

thank you!