In addition, above these lines, when you talk about the port:

```
# port of the Cosmos service (webhdfs or httpfs) listening for persistence operations
orionagent.sinks.hdfs-sink.cosmos_port = 14000
```

I'd suggest to add infinity to the list (as you have done for hdfs_api parameter) and warn about that different HDFS backends may be using different ports (to avoid users get the false impression that all them use port 14000).

In addition (although not purely related with this PR :), I think that GitHub markdown language allows to assign a "syntax colouring" for code blocks. In that case, it would be useful to use a syntax appropriated for configuration files (so the comment lines get "shadowed" and the properties lines get highlighted).