Update docs

I've added some documentation which I found was missing.

Can someone please prof read it :) e.g. @petya2164 or @mortenvp?
This makes sense to me since `factory(uint32_t max_symbols,uint32_t symbol_size)` works on every instance