[webcomponents] [Custom]: "All Algorithms in One Diagram" (bugzilla: 27780) (#158)

Title: [Custom]: "All Algorithms in One Diagram" (bugzilla: 27780)

Migrated from: https://www.w3.org/Bugs/Public/show_bug.cgi?id=27780

----
comment: 0
comment_url: https://www.w3.org/Bugs/Public/show_bug.cgi?id=27780#c0
*Anne* wrote on 2015-01-07 15:06:15 +0000.

Per this diagram the prototype is changed after any callbacks are invoked but that is wrong per the prose.

----

comment: 1
comment_url: https://www.w3.org/Bugs/Public/show_bug.cgi?id=27780#c1
*Dimitri Glazkov* wrote on 2015-01-08 19:19:14 +0000.

Is this diagram useful, btw? I can't decide. My hesitation to remove it may be colored by hours I spent hand-coding it :P

----

comment: 2
comment_url: https://www.w3.org/Bugs/Public/show_bug.cgi?id=27780#c2
*Anne* wrote on 2015-01-09 06:57:26 +0000.

I would love more diagrams in specifications and once I find a sensible way to generate them I would include them elsewhere too. It helps a lot with checking the overall flow or interdependencies.

----

comment: 3
comment_url: https://www.w3.org/Bugs/Public/show_bug.cgi?id=27780#c3
*Michael[tm] Smith* wrote on 2015-01-09 20:25:41 +0000.

(In reply to Dimitri Glazkov from comment #1)
> Is this diagram useful, btw? I can't decide. My hesitation to remove it may
> be colored by hours I spent hand-coding it :P

(In reply to Anne from comment #2)
> I would love more diagrams in specifications

Agreed with Anne here. I think in general spec readers/reviewers/implementors really appreciate and benefit from good diagrams, so trying to provide good ones is a great goal.

(And I think diagrams are one of those things that users of the spec often end up just taking for granted when they have them; it's one of those many things that reviewers don't take time to make positive comments about. Instead, you're only going to hear from them when there's something wrong in the diagram. That suggests that if you want to measure whether a diagram is being used, you should put some easter-eggish error into it to see how many people notice and comment...)

---
Reply to this email directly or view it on GitHub:
https://github.com/w3c/webcomponents/issues/158

Received on Monday, 6 July 2015 07:37:38 UTC