Comment by lazyier

It is an improvement. Having documentation include with source code means that they can updated together and is less likely to be out of date.

Provided, of course, they don't use the github wiki stuff or use separate repos for documentation.