Re: [whatwg/dom] "unclosed node of node" reads confusingly (#285)

I'm really trying to reach for a positive attribute here, because - in addition to the already confusing wording - saying "not unclosed" is confusing by itself. Double-negation is an anti-pattern both in APIs and in English (and here we have an API written *in* English!).  "Reachable" passes this test, as you have "reachable" and "not reachable".

However, your example is compelling.  What we're really trying to talk about is whether or not A is hidden from B by a closed shadow boundary.  Maybe "shadow-hidden"?  That's still a positive attribute, and it explicitly invokes the shadow boundary - it's clearer that your two script-created elements are "not shadow-hidden", because there's no shadows between them!

---
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/dom/issues/285#issuecomment-237060005

Received on Tuesday, 2 August 2016 22:05:32 UTC