Hi, On Mon, Nov 14, 2016 at 03:29:58PM +0000, Mirek Svoboda wrote: > What if we have the descriptions in the source code, serving as a single > source of truth, and generate the JSON schema file from the source code > upon build?
... or on the fly. That's what I was thinking as well. Ie "show stats json-schema" and use that output. > There might be also another use case for the descriptions in the source > code in the future, though cannot come with an example now. Clearly the source code doesn't need the descriptions, however it's the easiest place to ensure consistency. When you add a new field and you only have to type 5 words in a 3rd column, you have no excuse for not doing it. When you have to open a file you don't know exists, or to try to remember what file this was because you remember being instructed to do so in the past, it's quite different. Regards, Willy

