Correct some confusing or incorrect statements.

I made a few tweaks to the docs on writing a service. There were a few statements that I believe are incorrect, and a few more that I found confusing as written.