Fix readme markup
[puppets] Remove superfluous require
[puppets] Extend the documentation of our modules