Re: [w3ctag/design-reviews] Rethink the TAG's review intake process. (PR #1102)

@marcoscaceres commented on this pull request.



> +  - "Progress: untriaged"
+  - "Review type: CG early review"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for sending us your design review.
+
+        Use links to content rather than pasting text into this issue. Issues are ephemeral and most of the material we are asking for has long term value.
+
+        Please preview the issue and check that the links work before submitting. Please make sure anyone with the link can access the document. We may refuse to review anything that is not public.
+
+  - type: input
+    attributes:
+      label: Explainer
+      description: An explainer must address user needs and contain examples of use. See our [explanation of how to write a good explainer](https://w3ctag.github.io/explainer-explainer/#introduction).

My only concern with the examples of usage is that it's asking for a solution to be "engineered". That risks locking in some kind of design (e.g., JS vs markup or whatever) - where there might be multiple ways to solve a problem. 

```suggestion
      description: An explainer must explain the value to end users and contain examples of use, even if hypothetical. See our [explanation of how to write a good explainer](https://w3ctag.github.io/explainer-explainer/#introduction).
```

-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3ctag/design-reviews/pull/1102#pullrequestreview-2875917980
You are receiving this because you are subscribed to this thread.

Message ID: <w3ctag/design-reviews/pull/1102/review/2875917980@github.com>

Received on Wednesday, 28 May 2025 17:38:56 UTC