input types, sort out example (bug doc-update)

also timwe asked which fields are required by zippy, is it all of them or just some?