[community-group] Pull Request: chore: Format resolver spec into individual markdown files

drwpow has just submitted a new pull request for https://github.com/design-tokens/community-group:

== chore: Format resolver spec into individual markdown files ==
## Changes

Without changing any content, organizes specification into individual markdown files to match the existing setup of this project.

### Minor adjustments

Also without adjusting any language or organization, some cleanup was made to better organize the sections which seemed unintentional. Examples:

**Before**

_Not only were example descriptions outside of the “Example” container, there were other instances of a single example being split between multiple examples, which seemed accidental:_

<img width="1704" height="1062" alt="before" src="https://github.com/user-attachments/assets/c4136a2c-8cee-4331-b822-710c70dd3f8b" />

<img width="1770" height="1478" alt="before-2" src="https://github.com/user-attachments/assets/8529c6b7-71dc-4185-845d-b2bb78e70794" />


**After**

_Examples are self-contained and follow a logical structure._

<img width="1756" height="1176" alt="after" src="https://github.com/user-attachments/assets/327eacd4-1934-438c-a07b-2042127acefa" />

<img width="1969" height="1475" alt="after-2" src="https://github.com/user-attachments/assets/7ab709a7-8cbb-45fb-a24c-65623afebae4" />

---

A minor cleanup to “references” was made, since ReSpec auto-generates this section correctly. Future additions will 



## How to Review

The proof this was only an organizational change is in the outline:

**Before**

<img width="866" height="1546" alt="before-outline" src="https://github.com/user-attachments/assets/2629fe3a-33c5-4be1-aa58-ba7800ddd248" />


**After**

<img width="866" height="1644" alt="after-outline" src="https://github.com/user-attachments/assets/de959e28-cef1-4b3d-aaee-63f322fe7d35" />

The last item: **Example 3**, only changed from “F” to “E” because of the change to “References” mentioned above—our updated version of ReSpec autogenerates this section, at the end.

Not shown in this screenshot, but all other sections match 1:1 with the original outline. The only difference being some headlines were consolidated into examples, which was the mistake mentioned above.


This PR is just for historic purposes


See https://github.com/design-tokens/community-group/pull/290


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

Received on Monday, 4 August 2025 02:19:56 UTC