(maint) update documentation for PDB-489
Merge pull request #1118 from wkalt/maint/producer-timestamp-documentation-fixes

(maint) update documentation for PDB-489