[hackers-guide,docs] Improve mangling docs further.