pedantic doc updates