[heycam/webidl] "lists of values that are passed by value" is confusing (#926)

The [definition of `FrozenArray`](https://heycam.github.io/webidl/#idl-frozen-array) says:

> Since FrozenArray<T> values are references, they are unlike sequence types, which are lists of values that are passed by value.

This sentence confused me for a bit since when I first read the "lists of values that are passed by value" I read the "that are passed by value" as a clause modifying "values", and then I went down a rathole of trying to think what that even means (and what defines how an arbitrary type is passed by value).  But then I concluded that "that are passed by value" actually modifies "lists", which makes it much less confusing.

It would be nice to restructure this sentence so it doesn't have that problem, for example by removing the "of values" or putting it in parentheses.  There are probably plenty of other options as well.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/heycam/webidl/issues/926

Received on Thursday, 24 September 2020 00:18:53 UTC