improved pod documentation