updated the location of the service description documentation
switch id's to uuids and add format validation