document halfDoc#post
document the onError callback
document halfDoc#post behaviour when fields