There is some information in the Service Definition that would fit better in our portal docs ( e.g. modules)

I think we can move some information from the Service Def.  Also, some information is unclear (as raised in the attached doc) 

https://docs.google.com/document/d/1_K4Q3FnT5yXqQiEKOize2N-Zj16gUHUWdhLYbeSwvWg/edit