Add README to documentation directory explaining its intent and usage.

r? @andym @robhudson @washort @diox