clarify some json-ability issues