Rewrite documentation around Services


 - https://hibernate.atlassian.net/browse/HSEARCH-1595
thanks, that wins because of brevity.