[doc] working on pub/sub documentation