achVendID allows a four-space Tag, which is not a valid Tag

Open Beginner friendly
#1,247 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
80/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown
Domain
documentation

Research direction

Read the Tag definition in the OpenType specification at the page URL and compare it with the achVendID explanation linked in the issue. Update the Tag wording so it accommodates the four-space blank value; done when both descriptions are consistent and the specification still states the valid non-space character limit.

Written by the indexing model from the issue text.

Description

OpenType spec
Description

The Tag spec says “A Tag value [...] must have one to four non-space characters”. However, the explanation of OS/2.achVendID says “This field can also be left blank (set to null, or a tag comprised of four space characters).” These statements are inconsistent. The achVendID convention seems useful, so I recommend changing the Tag spec to say “zero to four non-space characters” or equivalent.

Page URL

https://learn.microsoft.com/en-us/typography/opentype/spec/otff

Content source URL

https://github.com/MicrosoftDocs/typography/blob/live/typographydocs/opentype/spec/otff.md

Dominant language
No language data
Stars
50
Forks
15
PR merge metrics
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MicrosoftDocs/typography-issues

All issues in MicrosoftDocs/typography-issues

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.