Re: PSA: publishing new WD of File API on April 21
On 4/15/15 10:23 AM, Arthur Barstow wrote: * This spec is now using Github https://w3c.github.io/FileAPI/ That repo is actually https://github.com/w3c/FileAPI/.
PSA: publishing new WD of File API on April 21
Hi All, A new Working Draft publication of File API is planned for April 21 using the following version as the basis: https://w3c.github.io/FileAPI/TR.html If anyone has any major concerns about this, please reply right away. A few notes about this spec: * This spec is now using Github https://w3c.github.io/FileAPI/ and the ED is https://w3c.github.io/FileAPI/Overview.html. PRs are welcome and encouraged. (I think it would be useful if this spec used ReSpec and if anyone can help with that port, please do contact me.) * The permissions of the spec's now obsolete CVS repository will be set to read-only. * After the Editors copy the open Bugzilla bugs [1] to Github Issues (or the last open Bugzilla bug is closed), the spec's Bugzilla component will be marked `Historical` and set to read-only. -Thanks, ArtB [1] https://www.w3.org/Bugs/Public/buglist.cgi?component=File%20APIlist_id=54713product=WebAppsWGresolution=---
Re: PSA: publishing new WD of File API on April 21
On Wed, Apr 15, 2015 at 7:23 AM, Arthur Barstow art.bars...@gmail.com wrote: * This spec is now using Github https://w3c.github.io/FileAPI/ and the ED is https://w3c.github.io/FileAPI/Overview.html. PRs are welcome and encouraged. (I think it would be useful if this spec used ReSpec and if anyone can help with that port, please do contact me.) This was actually already next on my list of specs to Bikeshed, as soon as I finish DOM (which I'm doing as I type this). WebIDL-heavy specs benefit a lot from being Bikeshedded, so all the IDL definitions get properly marked up for the linking database. ^_^ ~TJ
Re: PSA: publishing new WD of File API on April 21
On 15 April 2015 at 07:26, Arthur Barstow art.bars...@gmail.com wrote: * This spec is now using Github https://w3c.github.io/FileAPI/ That repo is actually https://github.com/w3c/FileAPI/. Since the most obvious github.io link is currently broken, would it make sense to move Overview.html to index.html? Does the name Overview.html hold special meaning?
Re: PSA: publishing new WD of File API on April 21
On 4/15/15 3:09 PM, Tab Atkins Jr. wrote: On Wed, Apr 15, 2015 at 7:23 AM, Arthur Barstow art.bars...@gmail.com wrote: * This spec is now using Github https://w3c.github.io/FileAPI/ and the ED is https://w3c.github.io/FileAPI/Overview.html. PRs are welcome and encouraged. (I think it would be useful if this spec used ReSpec and if anyone can help with that port, please do contact me.) This was actually already next on my list of specs to Bikeshed, as soon as I finish DOM (which I'm doing as I type this). WebIDL-heavy specs benefit a lot from being Bikeshedded, so all the IDL definitions get properly marked up for the linking database. ^_^ :-). Arun , Jonas - unless we otherwise from you, we'll assume this is `all good` from your perspective. -Thanks, AB
Re: PSA: publishing new WD of File API on April 21
On Wed, Apr 15, 2015 at 7:23 AM, Arthur Barstow art.bars...@gmail.com wrote: Hi All, A new Working Draft publication of File API is planned for April 21 using the following version as the basis: https://w3c.github.io/FileAPI/TR.html Note that this version appears to be based off the Overview-FAWD.xml file in the CVS repo, which hasn't been touched in 5 years. The file Overview-FA.xml is much more recent and appears to be what the current file at http://www.w3.org/TR/FileAPI/ is based on (note the relative positions of the FileList and Blob sections - in Overview-FA.xml and the current TR, FileList comes first). I suspect, then, that the file you're referencing is out-of-date and shouldn't be used. ~TJ
Re: PSA: publishing new WD of File API on April 21
On 4/15/15 5:56 PM, Tab Atkins Jr. wrote: On Wed, Apr 15, 2015 at 7:23 AM, Arthur Barstow art.bars...@gmail.com wrote: https://w3c.github.io/FileAPI/TR.html Note that this version appears to be based off the Overview-FAWD.xml file in the CVS repo, which hasn't been touched in 5 years. The file Overview-FA.xml is much more recent and appears to be what the current file at http://www.w3.org/TR/FileAPI/ is based on (note the relative positions of the FileList and Blob sections - in Overview-FA.xml and the current TR, FileList comes first). I suspect, then, that the file you're referencing is out-of-date and shouldn't be used. I didn't use either of those files but Overview.html, as directed by Arun. (He told me he stopped editing the Overview-FA.xml file some type ago). -Thanks, AB
Re: PSA: publishing new WD of File API on April 21
On Wed, Apr 15, 2015 at 3:00 PM, Arthur Barstow art.bars...@gmail.com wrote: On 4/15/15 5:56 PM, Tab Atkins Jr. wrote: On Wed, Apr 15, 2015 at 7:23 AM, Arthur Barstow art.bars...@gmail.com wrote: https://w3c.github.io/FileAPI/TR.html Note that this version appears to be based off the Overview-FAWD.xml file in the CVS repo, which hasn't been touched in 5 years. The file Overview-FA.xml is much more recent and appears to be what the current file at http://www.w3.org/TR/FileAPI/ is based on (note the relative positions of the FileList and Blob sections - in Overview-FA.xml and the current TR, FileList comes first). I suspect, then, that the file you're referencing is out-of-date and shouldn't be used. I didn't use either of those files but Overview.html, as directed by Arun. (He told me he stopped editing the Overview-FA.xml file some type ago). Oh god, you're right, it looks like Arun has been directly editting the generated HTML since Jan 2013. Confusingly, there's a single commit to Overview-FA.xml in Nov 2014 which just updates the Prev/Current links in the header; the immediately preceding commit is from Jan 2013, though, while Overview.html has been editted repeatedly in that span. Ugh, working with the XML was a lot easier. Darn. Arun, buddy, I'm sorry you had to go through the pain of directly editting generated HTML. ~TJ
Re: PSA: publishing new WD of File API on April 21
On 4/15/15 3:54 PM, Martin Thomson wrote: On 15 April 2015 at 07:26, Arthur Barstow art.bars...@gmail.com wrote: * This spec is now using Github https://w3c.github.io/FileAPI/ That repo is actually https://github.com/w3c/FileAPI/. Since the most obvious github.io link is currently broken, would it make sense to move Overview.html to index.html? That would be fine with me (we've already done that for a few specs we've recently migrated to Github) and it seems like a reasonable `best practice` to follow. Does the name Overview.html hold special meaning? We'll have to ask the Editors and I believe Jonas is OOO now and Arun is part-time. I filed an Issue so they can provide some input and if I don't hear otherwise from them, I'll plan to make the filename change before the new WD is published. -Thanks, AB
Re: PSA: publishing new WD of File API on April 21
On Wed, Apr 15, 2015 at 12:54 PM, Martin Thomson martin.thom...@gmail.com wrote: On 15 April 2015 at 07:26, Arthur Barstow art.bars...@gmail.com wrote: * This spec is now using Github https://w3c.github.io/FileAPI/ That repo is actually https://github.com/w3c/FileAPI/. Since the most obvious github.io link is currently broken, would it make sense to move Overview.html to index.html? Does the name Overview.html hold special meaning? No, it's just an older tradition for specs in some working groups. I also recommend using index.html as the generated file name (and am doing so in my Bikeshedding, which is now underway). ~TJ
