Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Continuous idl #51

Merged
merged 11 commits into from Apr 21, 2016
Merged

Continuous idl #51

merged 11 commits into from Apr 21, 2016

Conversation

plehegar
Copy link
Member

  • Switch to continuous IDL support to facilitate linking
  • Method description are rewritten as short algorithm to facilitate figuring out the values returned
  • Improved introduction to "Extensions to Performance interface" section
  • Some link cleanup
  • other minor respec improvement

Hopefully, this is a step forward towards cleaning up the spec a bit but we'll need additional PRs to improve its coherence and consistency.
Merge with care, ie someone needs to be convinced that I didn't mess up the functions and that this is an improvement before we merge.

@@ -294,59 +285,52 @@
<section id="resources-included">
<h3>Resources Included in the <a>PerformanceResourceTiming</a> Interface</h3>

<p>All resources <a title='fetch' href="http://www.w3.org/TR/html5/infrastructure.html#fetch">fetched</a> by the current <a href="http://www.w3.org/TR/html5/browsers.html#browsing-context">browsing</a> [[!HTML5]] or worker [[!WORKERS]] context's MUST be included as <a>PerformanceResourceTiming</a> objects in the <a href="http://www.w3.org/TR/performance-timeline-2/#sec-performance-timeline">Performance Timeline</a> of the relevant context. Resources that are retrieved from <a href="http://www.w3.org/TR/html5/browsers.html#relevant-application-cache" title='relevant application cache'>relevant application caches</a> or local resources MUST be included as <a>PerformanceResourceTiming</a> objects in the <a href="http://www.w3.org/TR/performance-timeline-2/#sec-performance-timeline">Performance Timeline</a> ([[!PERFORMANCE-TIMELINE-2]]). Resources for which the <a title='fetch' href="http://www.w3.org/TR/html5/infrastructure.html#fetch">fetch</a> was initiated, but was later aborted (e.g. due to a network error) MUST be included as <a>PerformanceResourceTiming</a> objects in the <a href="http://www.w3.org/TR/performance-timeline-2/#sec-performance-timeline">Performance Timeline</a> and MUST contain initialized attribute values for processed substeps of the <a href="#processing-model">processing model</a>.</p>
<p>All resources <a title='fetch' href="https://www.w3.org/TR/html5/infrastructure.html#fetch">fetched</a> by the current <a href="https://www.w3.org/TR/html5/browsers.html#browsing-context">browsing</a> [[!HTML5]] or worker [[!WORKERS]] context's MUST be included as <a>PerformanceResourceTiming</a> objects in the <a href="https://www.w3.org/TR/performance-timeline-2/#sec-performance-timeline">Performance Timeline</a> of the relevant context, up to the <a>resource timing buffer size limit</a>. Resources that are retrieved from <a href="https://www.w3.org/TR/html5/browsers.html#relevant-application-cache">relevant application caches</a> or local resources MUST be included as <a>PerformanceResourceTiming</a> objects in the <a href="https://www.w3.org/TR/performance-timeline-2/#sec-performance-timeline">Performance Timeline</a> [[!PERFORMANCE-TIMELINE-2]]. Resources for which the <a title='fetch' href="https://www.w3.org/TR/html5/infrastructure.html#fetch">fetch</a> was initiated, but was later aborted (e.g. due to a network error) MUST be included as <a>PerformanceResourceTiming</a> objects in the <a href="https://www.w3.org/TR/performance-timeline-2/#sec-performance-timeline">Performance Timeline</a> and MUST contain initialized attribute values for processed substeps of the <a href="#processing-model">processing model</a>.</p>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... up to the resource timing buffer size limit.

I think this clashes with PerfObserver: it sounds like observer should not get notifications if the buffer is full. I propose we drop that part of the sentence entirely from this section.

Also, for the last part on "initiated, but aborted".. we need to resolve #12.

@igrigorik
Copy link
Member

Modulo a few minor knits, this is a huge improvement.. thanks for taking this on!

@plehegar
Copy link
Member Author

Didn't use the []'s shorthand yet but could be dealt with separately.
#12 remains

@igrigorik
Copy link
Member

After another careful read through it.. 👍 - merging.

I don't think we need to block this pull on #12.

@igrigorik igrigorik merged commit 1602c6d into gh-pages Apr 21, 2016
@plehegar plehegar deleted the continuous-idl branch June 3, 2016 13:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants