12:52:30 RRSAgent has joined #dwbp 12:52:30 logging to http://www.w3.org/2016/10/28-dwbp-irc 12:52:32 RRSAgent, make logs 351 12:52:32 Zakim has joined #dwbp 12:52:34 Zakim, this will be DWBP 12:52:34 ok, trackbot 12:52:35 Meeting: Data on the Web Best Practices Working Group Teleconference 12:52:35 Date: 28 October 2016 12:53:48 agenda: https://www.w3.org/2013/dwbp/wiki/Meetings:Telecon20161028 12:53:52 chair: hadleybeeman 12:54:00 scribe: phila 12:54:09 scribeNick: phila 12:54:18 RRSAgent, make logs public 13:00:28 annette_g has joined #dwbp 13:01:25 BernadetteLoscio has joined #dwbp 13:02:44 Caroline_ has joined #DWBP 13:03:39 riccardoAlbertoni has joined #DWBP 13:04:46 Present+ Caroline_ 13:04:52 present+ BernadetteLoscio 13:04:58 present+ annette_g 13:05:00 present+ 13:05:17 present+ newton 13:05:18 Topic: Minutes from previous call 13:05:20 Hello! Newton and I are together and he just connected WebEx :) 13:05:35 present+ hadleybeeman 13:05:35 -> https://www.w3.org/2016/09/30-dwbp-minutes Minutes from 30 Sept 13:05:47 present+ riccardoAlbertoni 13:05:50 NOTUC 13:06:28 RESOLVED: Accept minutes of 30 September 13:06:58 Topic: BP Status 13:07:08 BernadetteLoscio: We have included some topics on the agenda... 13:07:08 https://www.w3.org/2013/dwbp/wiki/Meetings:Telecon20161028#Main_agenda 13:07:30 Topic: Can we include a data portal as an evidence or we should include a specific dataset from the portal? For example: worldbank, open data portal nasa. 13:07:56 https://docs.google.com/spreadsheets/d/1RhMGyG0ZYb73RkteYr39Xqt7f5xi0BUQmSiDqjkHOSA/edit#gid=853876221 13:08:03 BernadetteLoscio: Everyone can take a look at the current status ^^ 13:08:24 BernadetteLoscio: We organised the evidence we have so far, counting evidence for each BP. 13:08:40 ... Some more critical than others. These are the ones listed on the agenda. 13:08:49 ... As it's more difficult to get implementations. 13:08:59 ... Because these BPs are not used in the real world. 13:09:24 ... What I see is that we have BPs, eg ones related to Metadata, having an API. These are easier to find evidence for - everyone does it. 13:09:45 ... But it's more difficult becausae people don't implement and also because it's hard to see if they have implemented it or not. 13:10:03 ... eg BP 26 avoid breaking changes to your API. How can we assess that? 13:10:12 +q 13:10:19 ... Same for data preservation. 13:10:45 ... For example, data quality info. Everyone knows it's important, but finding it for humans and machines can be hard. usually find publisher but rare to find more 13:11:01 BernadetteLoscio: So this is one of the questions. 13:11:18 ... So should we implement our own datasets as evidence? 13:11:36 ... I couldn't find evidence for this BP. But it's possible to implement them. 13:11:47 ... We are trying to collect evidence from datasets already available. 13:12:19 ... We're asking people to evaluation their datasets against the BPs. But we don't have a new dataset created to show that it's possible to implement. 13:12:29 ... So should we do it ourselves? 13:12:31 ack p 13:12:44 q+ 13:13:24 PWinstanley: One of the things that might be helpful for BP26, for things like the ?? openAPI recommendations for cities. We could use the evidence of their recommendation around management of APIs. 13:13:58 ... Also, Michael Stoiwe's publication from Mulesoft (?) guide to developing rest interfaces and APIs, he addresses the issue of stability cf. agile development processes. 13:14:11 ... Maybe we could ask him directly for illustrations? 13:14:34 6Aika 13:14:47 s/??/6Aika/ 13:14:55 Vipuvoimaa 13:14:59 https://www.w3.org/TR/prov-implementations/ 13:15:26 hadleybeeman: On provenance... the implementations from when PROV was put through Rec, that might provide some useful evidence. 13:15:26 s/Stoiwe/Stowe/ 13:15:41 hadleybeeman: BP5 13:16:25 BernadetteLoscio: OK, matbe I need to think differently. I thought we had to show a dataset or portal that offers data provenance info both in human and machine readable way, the latter might use prov. 13:16:47 hadleybeeman: All of the implementations in the Prov implementation report might provide pointers. 13:16:57 q+ to mention DBpedia 13:17:26 ack a 13:17:26 ack a 13:17:43 https://github.com/6aika , https://www.avoindata.fi/data/fi/dataset/open-api-recommendations-for-cities 13:17:49 annette_g: For prov, I'd suggest looking at scientific datasets, it's important in this field. But they may not use Prov. 13:18:15 q+ 13:18:25 ... As for putting up our own, that prob won't be seen as legitimate, so I'd caution against that. But I like Peter's suggestion for looking for other guides. 13:18:35 ack b 13:18:42 https://www.amazon.co.uk/Undisturbed-Rest-Guide-Designing-Perfect/dp/1329115945 13:19:01 BernadetteLoscio: In this case, we need help. For BPs related to APIs, we don't feel comfortable making this evaluation. 13:19:06 https://www.mulesoft.com/lp/ebook/api/restbook 13:19:25 BernadetteLoscio: I don't know how to show that the BP was implemented by someone else. 13:19:40 ... Also wrote to annette_g as she knows this field well. 13:19:58 RRSAgent, draft minutes 13:19:58 I have made the request to generate http://www.w3.org/2016/10/28-dwbp-minutes.html phila 13:20:13 annette_g: I'll do what I can. 13:20:34 ... I worked on the building of APIs where we made sure we didn't break it but I'm not sure that we recorded it. 13:21:34 annette_g: There are lots of instances of people writing about API development. I'd say pointing to other people's BPs makes sense. 13:21:56 hadleybeeman: Thinking back to our first F2F and saying that each BP needs to be testable. 13:22:08 ... It is a BP doc, not a spec. 13:22:23 ... Unless we had a before and after to point to... 13:22:35 annette_g: You might find a an API that pinted to a previous version. 13:22:50 hadleybeeman: is there a way to tighten up the language in the BP to make it easier to test. 13:23:00 ack me 13:23:00 phila, you wanted to mention DBpedia 13:23:19 phila: pointing to other people's recommendations and guidelines is fine, especially for something like this. 13:23:27 ...That's one way to do it. 13:23:55 ...Then — we just got some evidence from Annette_g but we didn't record it . She just said we're careful not to break stuff. 13:24:08 ...We can use that as evidence 13:24:13 +q 13:24:35 ...You don't have to necessarily think of "here is an example of API v 2. And here is v1. And look! they're backwards compatible". Thats more than you need to do. 13:24:59 ...Evidence for machine readable provenance info could be harder. dbPedia's provenance is all wikipedia. Is that enough? not sure. 13:25:06 ...Annette_g has some scientific examples. 13:25:16 ...That's the kind of approach we can use. 13:25:37 annette_g: I don't have much difficulty finding blog examples for API not breaking. 13:25:44 ... Get blog posts about twitter API for exdample 13:25:52 ack b 13:25:58 s/exdample/example 13:26:18 BernadetteLoscio: What we discussed before was that we'd have a link to a dataset or a data portal to show as evidence 13:26:29 ... So that's what we looked for. 13:26:37 ... Makx suggested that we used Share-PSI as evidence 13:26:42 ... because they use our BPs. 13:26:55 q+ 13:26:57 this is cool: https://blog.twitter.com/2016/versioning-is-coming-to-twitter-s-ads-apis 13:27:05 ack p 13:27:13 phila: It depends on which BP we're talking about . 13:27:36 ...The reason Makx brings it up is that he wrote things for the European Commission, citing our best practices. Those have become official EC publications. 13:28:04 ...If we can present the director with a mixture: direct evidence for some, indirect evidence for others, and for those that are harder we have people saying they've done it. 13:28:14 ...Finding blog posts describing what people did is also helpful there. 13:28:27 ...What you're trying to present to the director: a body of evidence that supports each of the BPs. 13:28:49 ...Some of the BPs around data enrichment will be hard. The only way will be to write to Ghisele and ask for examples. 13:28:54 q? 13:29:13 illustration of discussion about API change; https://www.troyhunt.com/your-api-versioning-is-wrong-which-is/ 13:30:27 BernadetteLoscio: It's clear, it's more flexible also, thanks 13:30:41 ... We'll use other strategies to get more evidence 13:31:47 BernadetteLoscio: We were evaluating the OD portal for NASA, Lewis hasn't answered yet 13:31:51 q+ to talk about NASA 13:32:26 BernadetteLoscio: We really need help, giving us ideas, also doing the evaluations 13:32:56 BernadetteLoscio: I evaluated the World Bank data portal. Should we have a 2nd review of that portal of that? 13:32:57 another useful one to triangulate BP 26: http://www.ben-morris.com/rest-apis-dont-need-a-versioning-strategy-they-need-a-change-strategy/ 13:33:21 BernadetteLoscio: Do we truist people who make the evaluation. If it's just the editors doing this? It wojld be nmice to have other people doing this. 13:33:35 s/nmice/nice/ 13:34:08 BernadetteLoscio: For example, I evaluated .... 13:34:11 http://labs.europeana.eu/api 13:34:19 s/wojld/would/ 13:34:45 BernadetteLoscio: I evaluated that, and I filled in the spreadsheet on Drive and write to Antoine 13:34:45 q? 13:34:55 ... I did the same on Open data ?? 13:35:04 s/??/impact map 13:35:32 ... I asked Lewis for feedback on NASA, but if no feedback from him we'll just use ours. 13:35:45 ack phila 13:35:45 phila, you wanted to talk about NASA 13:36:19 phila: Although there is nothing wrong with checking your evaluation, or sending the team whose data it is your evaluation — but i wouldn't worry if you don't get a response. 13:36:24 ...We will trust whoever does the evaluation. 13:37:05 ...And for NASA, perhaps Jeanne Holm? She chaired the W3C eGov interest group and used to be involved with the us Data.Gov. 13:37:15 ...She'll know who to contact. 13:38:02 s/us Data.Gov/US Data.Gov 13:38:19 PWinstanley: I spoke to her recently. If you send me an email, bernadette, I'll forward it to her. 13:38:27 q+ 13:38:29 phila: But those confirmations are "nice to have". Your evaluation is fine. 13:38:38 ...You don't have to get your evaluation checked by someone else. 13:38:48 BernadetteLoscio: Thanks to Peter as he's helping a lot 13:38:53 ... putting us in contact with a lot of people 13:39:00 PWinstanley: pleasure 13:39:02 q? 13:39:08 ack c 13:39:17 q+ Caroline_ 13:39:49 BernadetteLoscio: When we are evaluating an OD portal, for example the World Bank, what's better to include the URL of the WB portal or the specific dataset? 13:39:59 hadleybeeman: That surely depends on the BP in question 13:40:12 BernadetteLoscio: Some of the datasets are in more than one format 13:40:47 hadleybeeman: I think it depends on which BP you're looking at. This is our internal record for W3C, no one's going to go into detailed checks. 13:40:48 q+ 13:40:55 q+ to talk about the form anad spreadsheet 13:41:04 BernadetteLoscio: So I think we answered most of my Qs 13:41:46 ack r 13:42:05 q+ 13:42:16 q+ to ask Bernadette about the email she wants me to send 13:42:19 riccardoAlbertoni: I have a similar problem when I post my evaluation of ?? which is a collection of datasets. Only some of the datasets follow specific BPs 13:42:36 ... Soo I indicated which dataset 13:42:43 s/Soo/So/ 13:42:47 q+ 13:42:51 ack me 13:42:51 phila, you wanted to talk about the form anad spreadsheet 13:43:05 phila: I think this conversation points to why the spreadsheet is easier to use than the form. 13:43:33 ...I tried filling in the form. I picked a dataset at random from data.io. I spend 1.5 hours and got less than half way through the form. 13:43:44 ...It was time consuming, and frustrating because I wanted to explain my responses. 13:44:01 ...Because this is a best practices document, it's useful to have the flexibility. 13:44:28 ...I will fill it in, because I want to contribute to this — but I find the "pass/fail/partial pass" is good, but you need a text field too' 13:44:47 q? 13:44:49 q+ 13:44:57 ack c 13:45:33 Caroline_: We also developed the Google doc sheet which is much easier. We're aware of the complexity of the form which is why it took so long to prepare. Hence the index on the left. 13:45:39 ... But we understand the complexity. 13:46:14 Caroline_: How can we approach other W3C members? 13:46:24 ... I know Karen said she'd help 13:46:28 q? 13:46:35 this is the template: https://docs.google.com/spreadsheets/d/1JE5pDy9YCu9eafQv50JJ3SauK4Jq1QmagV-GCDNY24E/edit 13:47:14 q- 13:47:25 Caroline_: And I wanted to talk about the deadline. We thought we have until Nov 10 to get this done, so we've been sending more and more e-mails, but we have 10/11 as the deadline 13:47:59 phila: Re contacting w3c members: we can go through the AC list (if you are a member). otherwise you write to individual AC reps for companies. 13:48:08 ...I might be able to help you choose companies. 13:48:30 q+ 13:48:54 ...In terms of deadlines: The Working group had to be formally extended until the end of December. That's a formal process. A note went out to the membership saying that had happened. 13:49:15 ...We will not get an extension beyond 31 December. So we have to get to PR by the end of November. 13:49:45 action: phila to contact friendly AC reps to ask for help 13:49:46 Created ACTION-297 - Contact friendly ac reps to ask for help [on Phil Archer - due 2016-11-04]. 13:50:14 q? 13:50:18 ack c 13:50:30 Caroline_: OK, we'll keep working hard and are grateful for the help. 13:50:39 ... We need more robust evidence 13:51:21 hadleybeeman: You asked me to ask the group for more help. Can i paste the list from today's agenda? 13:51:24 BernadetteLoscio: Sure 13:52:19 hadleybeeman: Anything else to cobver today? 13:52:28 s/cobver/cover 13:52:32 q+ 13:52:37 ack me 13:52:37 hadleybeeman, you wanted to ask Bernadette about the email she wants me to send 13:53:01 BernadetteLoscio: We need suggestions for sci data portals 13:53:15 action: newton to update form with new possibilities of answering (partial fail and partial pass) 13:53:15 Created ACTION-298 - Update form with new possibilities of answering (partial fail and partial pass) [on Newton Calegari - due 2016-11-04]. 13:53:35 BernadetteLoscio: Feel free to send us a message with possible evidence, a dataset, a portal etc. 13:53:49 ack r 13:54:19 riccardoAlbertoni: If I understand, we're also looking for references to other BP docs etc. Are we going to use the same form to collect this evidence? 13:54:23 BernadetteLoscio: What's easier? 13:54:49 riccardoAlbertoni: if the doc counts as much as a dataset for our purposes, then ... 13:54:50 q+ 13:55:19 BernadetteLoscio: We can make this distinction when compiling the report 13:55:38 riccardoAlbertoni: OK, we'll use the same form and the editors will make the distinction. 13:55:44 BernadetteLoscio: ANd if we have Qs we'll contact you. 13:55:48 ack p 13:55:56 -> https://www.w3.org/2013/share-psi/lg/CzechRepublic/ Share-PSI example 13:56:00 phila: This may be relevant... This is an example from Share-PSI 13:56:10 ...That is a local guide, from the Czech Republic. 13:56:44 ...It tells you exactly which of the best practices that Share-PSI adopted, that are recommended by the Czech government. 13:56:54 ...There are 39 of them, for each country . 13:57:01 -> https://www.w3.org/2013/share-psi/bp/ BP page 13:57:04 +q 13:57:06 s/for each/one for each 13:57:17 https://www.w3.org/2013/share-psi/lg/ 13:57:35 q? 13:57:40 ack p 13:58:01 PWinstanley: Are we going to be sending this request to Share-PSI 13:58:35 ... Some targeted e-mails would be helpful 13:59:04 Topic: Next meeting 13:59:30 hadley I can't hear you 13:59:32 hadleybeeman: Let's set our next call now. If our deadline for evidence is 10 Nov, that's almost 2 weeks. Do we need a call next Friday? 13:59:44 BernadetteLoscio: For me I don't think we need next week 13:59:59 hadleybeeman: So our next call is 11/11 (a date that works on both sides of t he Atlantic) 14:00:04 So DNM is 11/11 14:00:09 good weekend! 14:00:11 bye! 14:00:52 RRSAgent, draft minutes 14:00:52 I have made the request to generate http://www.w3.org/2016/10/28-dwbp-minutes.html phila 14:33:57 annette_g has joined #dwbp 16:03:33 Zakim has left #dwbp 16:04:12 RRSAgent, bye 16:04:12 I see 2 open action items saved in http://www.w3.org/2016/10/28-dwbp-actions.rdf : 16:04:12 ACTION: phila to contact friendly AC reps to ask for help [1] 16:04:12 recorded in http://www.w3.org/2016/10/28-dwbp-irc#T13-49-45 16:04:12 ACTION: newton to update form with new possibilities of answering (partial fail and partial pass) [2] 16:04:12 recorded in http://www.w3.org/2016/10/28-dwbp-irc#T13-53-15