> +In the same vein the special action @code{doc} describes it's service

Should be "its"

> +when called without an argument or describes a service-specific action
> +when called with the action as the additional arguments. You can even
> +get the list of the service-specific actions a service provides when
> +using with the additional argument @code{list-actions}.

Please use two spaces at the beginning of sentences.