tried to humanise the first bit of generator code
Added nameapce to docs
improved docs