(maint) update documentation for PDB-489