Please help me with documentation

[Andrei Alexandrescu via Digitalmars-d]

... a la https://github.com/D-Programming-Language/phobos/pull/2867. 
Chip in - we need any improvement, small and large. -- Andrei