June 24, 2018 11:34 PM, "Guus Sliepen" <g...@debian.org> wrote:
> On Sun, Jun 24, 2018 at 07:46:06PM +0000, Zenon Mousmoulas wrote: > >> I posted an updated ITP (should it be a new submission?) but let me try >> again, also correcting the >> license (s/MIT/Expat/). As for digger, I am afraid that is part of the >> acronym chosen by (the >> forked) upstream. >> >> Package: wnpp >> Severity: wishlist >> Owner: Zenon Mousmoulas <zmo...@noc.grnet.gr> >> >> * Package name : jiq >> Version : 0.6.0+git20180621.a79e8b2-1 >> Upstream Author : Giovanni T. Parra >> * URL : https://github.com/fiatjaf/jiq >> * License : Expat >> Programming Lang: Go >> Description : json incremental digger (jid) with jq > > Even though the name jid stands for json incremental digger, you don't > need to include that in the description. I'd certainly not use it in the > short description, but mention it in the long description so one can > still search for "incremental digger" and find this package. Also, the > acronym JSON should be spelled with all caps. > >> jiq is a fork of jid (https://github.com/simeji/jid) using >> jq (https://stedolan.github.io/jq) under the hood. > > I would not mention these facts as the first thing in the description. > >> It is a command line tool that can be used to interactively drill >> down on json input using jq filtering queries. > > That's useful information. I'd still try to reword "drill down". > >> jiq calls jq and requires that it can be found in PATH. > > This is useless information. Your package should have a Depends: jq, so > this will be taken care of automatically when you install your package. Right. It was just another piece of upstream readme I didn't consider stripping out. > Just like you won't see "foo uses the GNU standard C library and > requires that it be found in the standard system library paths or in > LD_LIBRARY_PATH". > > Ok, it's easy to criticize, so let me try to make a description myself, > and then you can decide if you want to pick some things from it: Fine, thanks. > Description: interactive JSON query tool using jq expressions > jiq is a command line tool that parses a JSON document and allows you > to interactively query and filter it using jq expressions. jiq also > provides suggestions and tab completion. I will just exclude this last statement about tab completion, because I am afraid it is not true. > . > jiq is a fork of jid, but fully supports the jq language (see > https://stedolan.github.io/jq). So, per your suggestions, here is the ITP: Package: wnpp Severity: wishlist Owner: Zenon Mousmoulas <zmo...@noc.grnet.gr> * Package name : jiq Version : 0.6.0+git20180621.a79e8b2-1 Upstream Author : Giovanni T. Parra * URL : https://github.com/fiatjaf/jiq * License : Expat Programming Lang: Go Description : interactive JSON query tool using jq expressions jiq is a command line tool that parses a JSON document and allows you to interactively query and filter it using jq expressions. . jiq is a fork of jid, which rather supports the jq language (see https://stedolan.github.io/jq).
