JAVA-3684: deprecate geohaystack

[terakilobyte]

This removes mention of geoHaystack from the docs and marks methods as deprecated.

[rozza]

Looks good, only one thing, where methods are deprecated you should also add the @deprecated tag and message in the java docs

[terakilobyte]

I thought I had added the @deprecated tags. Do you mean to add a quick note within the method docs it is deprecated and what to use instead?

[rozza]

@terakilobyte - here's an example:

mongo-java-driver/driver-core/src/main/com/mongodb/event/ConnectionPoolListener.java

Lines 133 to 138 in 8574c6d

	* @deprecated Prefer {@link #connectionClosed} Implementations should NOT implement this method at all, instead relying on
	* the default no-op implementation. If an application implements both this method and connectionClosed, the application risks
	* double-counting events.
	*/
	@Deprecated
	default void connectionRemoved(ConnectionRemovedEvent event) {

[terakilobyte]

I've added to the method docs for the public facing methods. I was unsure if it needed to be done for the methods in internal based on driver policy.

[rozza]

@terakilobyte unfortunately you have to double annotate with Java once for thing being deprecated and then again in the javadoc. Scala is nicer as the annotation is combined.

I've updated the java docs and will squash and merge.

Many thanks