add descriptions

more detailed explanation of the problem including links to documentation, bugs, D3, etc.