Re: [community-group] Design token additional properties (description, type, extensions) need to be in 5.2.x instead of 5.3, 5.4 etc. (#154)

@c1rrus I agree the current structure creates duplication of headers, but I find that structure more scannable when looking at the outline. Your proposed changes will DRY up the document, but I don't think that's worth the tradeoff of losing a more scannable outline.

Combining token and group definitions for each property will increase the complexity of each of those explanations and diminish the readability of those definitions IMO.

I propose we keep **Design Token** and **Groups** as top-level sections and adjust the heading levels beneath to create alignment as originally proposed by @lauthieb.

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


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

Received on Monday, 31 October 2022 13:15:45 UTC