{"id":20595380,"url":"https://github.com/adobe-type-tools/feature_file_change_review","last_synced_at":"2026-03-19T16:36:46.137Z","repository":{"id":258020391,"uuid":"868996544","full_name":"adobe-type-tools/feature_file_change_review","owner":"adobe-type-tools","description":"Public review of tentative changes to the Adobe OpenType Feature File Format Specification","archived":false,"fork":false,"pushed_at":"2024-10-15T21:39:44.000Z","size":194,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-01-17T00:43:13.132Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adobe-type-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-07T14:41:17.000Z","updated_at":"2024-10-15T21:39:48.000Z","dependencies_parsed_at":"2024-10-17T10:10:32.484Z","dependency_job_id":"361c4229-0163-481d-ad20-be1df2b8d3bf","html_url":"https://github.com/adobe-type-tools/feature_file_change_review","commit_stats":null,"previous_names":["adobe-type-tools/feature_file_change_review"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adobe-type-tools%2Ffeature_file_change_review","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adobe-type-tools%2Ffeature_file_change_review/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adobe-type-tools%2Ffeature_file_change_review/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adobe-type-tools%2Ffeature_file_change_review/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adobe-type-tools","download_url":"https://codeload.github.com/adobe-type-tools/feature_file_change_review/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242230702,"owners_count":20093623,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T08:12:51.000Z","updated_at":"2026-03-08T12:40:08.167Z","avatar_url":"https://github.com/adobe-type-tools.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenType Feature File Specification Additions for Variable Values: Public Review\n\nThe Adobe Type Team has been working to extend the OpenType Feature File\nSpecification to add direct support for variable fonts. These additions will\nprovide a new workflow in which a single feature file can be applied to an\nalready-variable \"base\" font, producing a full OpenType font with layout\nfeatures (and other additional tables). Compared with the currently predominant\n\"merging\" workflow, this new syntax makes it easier to reference designspace\nlocations in kerning or other values that are not associated with a given\nmaster, eliminates the ambiguity of 0 values in a master font, and provides\nother advantages.\n\nWe are introducing these specification changes in two stages:\n\n * Stage 1, which is now ready for public review, adds support for variable\n   values.\n * Stage 2, which should be ready in the first half of 2025, will add support\n   for feature variations (such as swapping one glyph for another based on axis\n   range conditions).\n\nSupporting these changes in our AFDKO toolset has required an extensive\nmodernization of much of its lower-level implementation, which is one reason\nthis project has taken longer than expected. However, the feature file syntax\nis also used in many tools not built or provided by Adobe. We have no control\nover whether our proposals are adopted by other toolsets, of course, but we\nhave tried to take the wider needs of the font development community into\naccount in developing these extensions. It is our hope that feature files will\ncontinue to be more or less portable between different font development\ntoolchains. \n\nThis specification review provides an opportunity for the Adobe type team to\nanswer questions about our choices, and if necessary to make adjustments to the\nspecification so that it is adopted as widely as possible.\n\nAdobe is now accepting comments on the stage 1 work via this GitHub repository.\nStart a [Discussion](https://github.com/adobe-type-tools/feature_file_change_review/discussions)\nabout whatever you would like to clarify, or add an\n[Issue](https://github.com/adobe-type-tools/feature_file_change_review/issues) to raise the\npossibility of adding to or changing the specification. (As always, it is\ngood practice to look through the lists of existing discussions and\nissues to avoid duplication.)\n\nThe review period for stage 1 ends on January 15th 2025. \n\nThe documentation provided includes:\n\n * A new [guide to variable features](https://adobe-type-tools.github.io/feature_file_change_review/Variable_Feature_Guide).\n   (This is probably the best place to start.)\n * A [revised specification](https://adobe-type-tools.github.io/feature_file_change_review/OpenTypeFeatureFileSpecification_diff.html) marked\n   with the differences from the previous version.\n * An annotated ANTLR 4 format [grammar](https://adobe-type-tools.github.io/feature_file_change_review/Grammar_Diff.html).\n * A short list of [ideas that were rejected](https://adobe-type-tools.github.io/feature_file_change_review/rejected_ideas).\n\nIn addition to this documentation we are providing an [example\nrepository](https://github.com/adobe-fonts/vffirst-source-serif) with\nthe sources for the Source Serif 4 Variable roman font reorganized to use the\nnew workflow.  It explains how to install a beta version of AFDKO that builds\nthese sources, and how the feature files can be modified to experiment with\nadditional aspects of the grammar. (Note that this beta version of our toolset\nis only partially tested and should not be used to attempt to build\nproduction-quality fonts.)\n\n## Who should review?\n\nAnyone is free to comment on and ask questions about the changes to the\nspecification, but here is some guidance on whether and how you might want to\nparticipate:\n\n * If you are only vaguely familiar with feature files, perhaps because you use\n   a font editor that produces and compiles them for you \"under the hood\", you\n   can probably trust that the developer of your editor will be reviewing these\n   changes on your behalf.\n * If you author your own feature files but your use of them is fairly routine,\n   you might read through the style guide to understand the new functionality,\n   and reference parts of the revised specification if you have further\n   questions.\n * If you make or have made extensive use of feature files to create fonts with\n   unusual layout features or other characteristics, we recommend reviewing the\n   style guide and specification to judge if you will be able to do what you\n   need to and if there are aspects of the process that might be improved.\n * If you develop a tool that creates, processes, or consumes feature files, we\n   recommend reviewing the proposed changes—including the ANTLR grammar—with an\n   eye toward adopting the extended grammar in the future, and perhaps to\n   engage with your community of users about it. If there are obstacles to that\n   adoption, please raise them in issues or discussions in the review\n   repository and we will try to work with you.\n\n## A note about the scope and role of feature files in font development   \n\nIn reading the proposals you will notice that there is more than one way of\nspecifying a variable metric or anchor, and several optional features such as\nnamed designspace locations. This flexibility is intentional, and reflects the\nrole of feature files as a \"fallback\" mechanism for less common layout needs\nthat may not be supported by an interactive font development system. The goal\nof the specification has been, and continues to be, to provide almost all of\nthe functionality of the OpenType shaping tables in a form that can be authored\nand reviewed by font designers and engineers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadobe-type-tools%2Ffeature_file_change_review","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadobe-type-tools%2Ffeature_file_change_review","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadobe-type-tools%2Ffeature_file_change_review/lists"}