publisher.go: provide documentation

A small touchup, adding documentation to the `Publisher` interface as well as to the `StdoutPublisher`.