Update docs once gftools builder is merged

Question

Update docs once gftools builder is merged

Opened this issue 4 years ago · 7 comments

m4rc1e commented 4 years ago

Would be nice to get people using gftools builder once it is merged.

googlefonts/gftools#278

RosaWagner commented 4 years ago

Agreed

Answer 1 · 2020-12-29T00:45:16.000Z

I think there should be a few fb checks for upstream repo structure, readme contents, etc, but something fancy that would be nice to check is a "fonts in use" or "title card" in the repo readme, like https://css-tricks.com/custom-styles-in-github-readmes/

Answer 2 · 2021-01-08T09:42:48.000Z

Do we have an FB upstream profile? it may be quite nice to have one.

cc @felipesanches

Answer 3 · 2021-01-11T04:05:02.000Z

Now it's merged, it would be great to update the Spec doc soon. As @moyogo is "new" I propose you to do this, what do you think? :)

Answer 4 · 2021-01-12T21:55:21.000Z

Should all the argument be available at the command line?
For example:

usage: gftools-builder.py [-h] [--debug] [--log-level LOG_LEVEL] [--stylespace-file STYLESPACE_FILE] [--stat STAT] [--build-variable BUILD_VARIABLE] [--build-static BUILD_STATIC]
                          [--build-webfont BUILD_WEBFONT] [--output-dir OUTPUT_DIR] [--vf-dir VF_DIR] [--tt-dir TT_DIR] [--ot-dir OT_DIR] [--woff-dir WOFF_DIR] [--autohint-t-t-f AUTOHINT_T_T_F]
                          [--axis-order AXIS_ORDER] [--family-name FAMILY_NAME] [--no-autohint] [--stylespace STYLESPACE]
                          file [file ...]

Answer 5 · 2021-01-13T04:22:38.000Z

Do you mean it's more elegant to require a config.yaml or whatever and only pass that 1 arg to the tool? It's reach across a lot of sub processes means a lot of args seems inevitable to me....

Answer 6 · 2021-01-13T08:55:00.000Z

Personally, I'd prefer if we kept the current minimal set of args. This will then ensure that people actually bother to make a config file and not just pass in arbitrary cmd line args each time they gen.