Pr doc fixes

closes #5836
closes #5899, following @jorisvandenbossche advice