The dos and don'ts of keeping it clean I'm going to begin this post with a list of dos and don'ts: don't nest content more than necessary use a limited number of keywords don't mix types unnecessarily don't write JSON that will take a lot of deciphering and decoding keep things as flat and simple as possible make the intention of the data as clear as possible think about how the JSON will most likely be interpreted without being restrictive or prescriptive use common concepts to indicate elements that are not straightforward values remember that arrays indicate order and dictionaries (or objects) are for unordered key/value access of information Example structure Now for a JSON structure I created to represent the internal structure of an EPUB following the dos and don'ts listed above: { "platform": "epub", "version": 3, "text-encoding": "UTF-8", "subdirectories":
Technology tips for writers, editors, designers, illustrators, programmers and publishers, and now Retro Gamers.