Rewrite documentation around Services


 - https://hibernate.atlassian.net/browse/HSEARCH-1595
that's hopefully explained in the "Provided Services" section. sigh I obviously made a mess of it, let me know if the next version makes this clearer.