W3C home > Mailing lists > Public > public-html-media@w3.org > May 2016

[encrypted-media] ReSpec sources cannot be used with the W3C HTML diff service

From: ddorwin via GitHub <sysbot+gh@w3.org>
Date: Fri, 20 May 2016 22:08:20 +0000
To: public-html-media@w3.org
Message-ID: <issues.opened-156059991-1463782099-sysbot+gh@w3.org>
ddorwin has just created a new issue for 
https://github.com/w3c/encrypted-media:

== ReSpec sources cannot be used with the W3C HTML diff service ==
When reviewing pull requests, it can be helpful to diff the resulting 
HTML with the previous version of the document. PRs often don't 
initially include the generated file (or it becomes out of date), so 
it is best to diff against the -respec.html files.

The problem is that the W3C HTML diff service 
(http://services.w3.org/htmldiff) does not expand relative addresses 
in the compared document relative to the source address. Such URLs 
become relative to the diff service (i.e. 
`https://services.w3.org/encrypted-media.js`). As a result, images, 
custom CSS, and - most importantly - the spec-specific JavaScript are 
not loaded. The missing JavaScript causes ReSpec to fail, which causes
 many diffs that have nothing to do with the actual change to be 
displayed.

As an example, see this [diff of the current ReSpec source against the
 generated 
file](http://services.w3.org/htmldiff?doc1=https%3A%2F%2Fw3c.github.io%2Fencrypted-media%2F&doc2=https%3A%2F%2Fw3c.github.io%2Fencrypted-media%2Fencrypted-media-respec.html).

Note: When diffing PRs, you must use the RawGit URLs for the raw 
GitHub URL of the -respec.html file you want to use.

Please view or discuss this issue at 
https://github.com/w3c/encrypted-media/issues/198 using your GitHub 
account
Received on Friday, 20 May 2016 22:08:22 UTC

This archive was generated by hypermail 2.3.1 : Friday, 20 May 2016 22:08:23 UTC