(retry) Service Definition documentation and fix

I added a `$port * 1` to convert the string value to an int so it will render in json without quotes, and documented how to use this define in the README.
Can you line up the arrows to conform to the style guide?