Hi, On Wed, 19 Jun 2019, Derrick Stolee wrote:
> On 6/19/2019 5:58 AM, Nguyễn Thái Ngọc Duy wrote: > > > +--json:: > > + Dump the entire index content in JSON format. This is for > > + debugging purposes and the JSON structure may change from time > > + to time. > > + > > "...purposes and the JSON structure may change from time to time" may be > better as "...purposes. The JSON structure is subject to change." It would probably make even more sense to mark this as an experimental feature for now (i.e. prefix the description with "(EXPERIMENTAL) ", so that users will have a harder time to miss that vague statement at the end. Once the feature stabilized enough, it would probably make sense to start versioning the JSON format (`--json[=<version>]`, defaulting to the latest). That would make this a pretty useful feature not only for debugging, I would imagine, but really would set a precedent for a better "API" for 3rd-party applications to use than the current one. Thanks, Dscho
