Re: [community-group] Additional property -> $comment (#146)

> What do you see as the difference between a "description" and a "comment"?

For example in a "font-size" token, you could add a "$description" for a specific token saying; "This font size should be used only for short opening paragraphs.", and add a "$comment" for the developer's user experience saying; "1.25rem - 20px". That way, tool manufacturers will also have a better predictor as to when to print a comment with a token in code and when not. Documentation tools can use the $description for display and know that it is intended for that purpose.

-- 
GitHub Notification of comment by reblim
Please view or discuss this issue at https://github.com/design-tokens/community-group/issues/146#issuecomment-1159798499 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Sunday, 19 June 2022 19:38:35 UTC