various updates to services docs