Adding a David badge to README
Amending code comments and fixing `$flush` argument