Rewrite documentation around Services


 - https://hibernate.atlassian.net/browse/HSEARCH-1595