more tweaks for json schema docs