Re: [heycam/webidl] Add namespaces (#121)

> +                <a>!</a> <a>ObjectCreate</a>(the <a>%ObjectPrototype%</a> of <var>realm</var>).
> +              </li>
> +
> +              <li>
> +                For each <a class='dfnref' href='#dfn-exposed'>exposed</a> <a class='dfnref'
> +                href='#dfn-regular-operation'>regular operation</a> <var>op</var> that is a <a
> +                class='dfnref' href='#dfn-namespace-member'>namespace member</a> of this namespace,
> +
> +                <ol>
> +                  <li>
> +                    Let <var>id</var> be <var>op</var>'s <a class='dfnref'
> +                    href='#dfn-identifier'>identifier</a>.
> +                  </li>
> +
> +                  <li>
> +                    Let <var>steps</var> be the following series of steps, given function argument

Having these "what does the function do?" steps in the middle of the "how to create the namespace object" algorithm makes it really hard to read: it's like a really big plot digression.

Please factor this out into a separate section, and just reference it here.

-- 
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/pull/121/files/23ba5276699574269bd955c67d60bd6ce586337f#r76253849

Received on Thursday, 25 August 2016 14:30:34 UTC