changes to compile to help build on stackato
some documentation