Bad docs are bad.

They need revising really..   I'm only making assumptions here