some updates to the docs and fixed some conversion bugs from the PoC into example