Developer documentation review and update.

It's been almost half a year since these documents were created and for example, the testing documentation was written at the same time as the first tests. The documentation got slowly out of date with the codebase and this update brings it up to date again.