[Minutes] 2016-02-26

A little late, sorry. Last week's minutes are at 
https://www.w3.org/2016/02/26-dwbp-minutes with a snapshot below.


       Data on the Web Best Practices Working Group Teleconference

26 Feb 2016

    See also: [2]IRC log

       [2] http://www.w3.org/2016/02/26-dwbp-irc

Attendees

    Present
           annette_g, newton, antoine, deirdrelee, Riccardo,
           Caroline, laufer BernadetteLoscio

    Regrets
           Phil

    Chair
           Hadley

    Scribe
           antoine

Contents

      * [3]Topics
          1. [4]BP-review status update
      * [5]Summary of Action Items
      * [6]Summary of Resolutions
      __________________________________________________________

    <hadleybeeman> present annette_g

    <hadleybeeman> [7]https://www.w3.org/2016/02/19-dwbp-minutes

       [7] https://www.w3.org/2016/02/19-dwbp-minutes

    <scribe> scribenick: antoine

    <scribe> scribe: antoine

    PROPOSED: to accept
    [8]https://www.w3.org/2016/02/19-dwbp-minutes

       [8] https://www.w3.org/2016/02/19-dwbp-minutes

    <annette_g> +1

    <deirdrelee> +1

    <Caroline> +1

    +1

    <laufer> +1

    <riccardoAlbertoni> +1

    <BernadetteLoscio> +1

    <hadleybeeman> +1

    <newton> +1

    RESOLUTION: accept
    [9]https://www.w3.org/2016/02/19-dwbp-minutes

       [9] https://www.w3.org/2016/02/19-dwbp-minutes

    <hadleybeeman> [10]http://w3c.github.io/dwbp/bp-status.html

      [10] http://w3c.github.io/dwbp/bp-status.html

BP-review status update

    BernadetteLoscio: annette made some updates
    ... and we have aproposal for organizing the API section

    hadleybeeman: first update on the table?

    <annette_g> I did make changes to versioning, too

    newton: we haven't updated the table much
    ... updated peter and riccardo's BP

    <Caroline> [11]http://w3c.github.io/dwbp/bp-status.html

      [11] http://w3c.github.io/dwbp/bp-status.html

    Caroline: this is the link that has not been updated
    ... even though some of the BPs might have been updated

    riccardoAlbertoni: I have pushed a revised version of the DQV
    example

    <Caroline> :)

    riccardoAlbertoni: and the BP table for my part

    <Caroline> thank you riccardoAlbertoni

    riccardoAlbertoni: please merge my pull request!
    ... (that's about BP7)

    <BernadetteLoscio> thanks a lot!

    riccardoAlbertoni: in the DQV section, we're refering to DQV
    ... the example BP is complete but depending on DQV issues we
    may have to update it.
    ... I promise I will maintain the two docs in synch.

    BP1: providing metadata

    <Caroline> but BernadetteLoscio worked a lot in DWBP during her
    vacation :)

    BernadetteLoscio: will work on it asap. Really soon

    hadleybeeman: how much work?

    BernadetteLoscio: not a lot.
    ... especially as I have worked on examples for the following
    BPs

    <riccardoAlbertoni> Just for the record, the revision on bp7
    were suggested by antoine, Sorry for not giving the proper
    credit ;)

    hadleybeeman: need help?

    <Caroline> thank you antoine :)

    <newton> action to newton to check if the turtle and RDFa
    examples are validated

    <trackbot> Error finding 'to'. You can review and register
    nicknames at <[12]http://www.w3.org/2013/dwbp/track/users>.

      [12] http://www.w3.org/2013/dwbp/track/users

    <hadleybeeman> action newton to check if the turtle and RDFa
    examples are validated

    <newton> action newton to check if the turtle and RDFa examples
    are validated

    <trackbot> Created ACTION-233 - Check if the turtle and rdfa
    examples are validated [on Newton Calegari - due 2016-03-04].

    <trackbot> Created ACTION-234 - Check if the turtle and rdfa
    examples are validated [on Newton Calegari - due 2016-03-04].

    BernadetteLoscio: no need for help for now. I'm going to write
    example and then ask feedback.

    hadleybeeman: before next week?

    BernadetteLoscio: yes

    hadleybeeman: are we in trouble because the things in this
    table is late?

    BernadetteLoscio: beginning of next week we can have a general
    view about the document

    BP 2: Provide descriptive metadata

    hadleybeeman: do you need someone to help you review this?

    newton: I can work with BernadetteLoscio
    ... get it done asap

    BP 3: Provide locale parameters metadata

    newton: same

    BP 4: Provide structural metadata

    <BernadetteLoscio> I'm gonna try to connect again

    newton: we're ok with both examples
    ... the test will have to be changed

    <BernadetteLoscio> I have connection probelms

    BP 5: Provide data license information

    newton: same. need to work on test and intented outcome

    BP 6: Provide data provenance information

    deirdrelee: issue was whether it needs a more detailed example
    ... I am considering extending the example early next week
    ... for the text I think what's there should be sufficient

    newton: if it's necessary to change the intend outcome please
    let us know!
    ... the editors will work on this!

    hadleybeeman: on all intended outcomes or only BP6?

    BP 7: Provide data quality information

    riccardoAlbertoni: example is finished
    ... for the test I didn't change, I wanted to see the other BP
    ... for now it seems aligned
    ... the question is whether we need to be more specific
    ... but that's a question for all BPs no ontoly this one!
    ... As soon as other BP's testing section are refined I could
    check and review

    hadleybeeman: that's something to do for evey BP!

    riccardoAlbertoni: we have to be careful: test mentions
    datasets, intended outcome mentions also distribution.
    ... I can try to align

    BP 8: Provide versioning information

    annette_g: there was already a good example

    <Caroline> thank you annette_g for improving the English :)

    annette_g: I think the test is ok.
    ... I've reviewed it but I may have written it too ;-)

    hadleybeeman: who'd be a good person?

    annette_g: I don't know

    newton: I've not merged the pull request now

    hadleybeeman: let's go BP by BP not step by step

    annette_g: I've looked at the content, my PR also makes
    suggestions for the intro

    newton: I will review the test

    <scribe> ACTION: newton to review annette's test for BP8
    [recorded in
    [13]http://www.w3.org/2016/02/26-dwbp-minutes.html#action01]

      [13] http://www.w3.org/2016/02/26-dwbp-minutes.html#action01]

    <trackbot> Created ACTION-235 - Review annette's test for bp8
    [on Newton Calegari - due 2016-03-04].

    BP 9: Provide version history

    annette_g: I think it's fine
    ... maybe need review from a vocabulary person

    <scribe> ACTION: antoine to review the voc aspect of BP9
    [recorded in
    [14]http://www.w3.org/2016/02/26-dwbp-minutes.html#action02]

      [14] http://www.w3.org/2016/02/26-dwbp-minutes.html#action02]

    <trackbot> Created ACTION-236 - Review the voc aspect of bp9
    [on Antoine Isaac - due 2016-03-04].

    BP 10: Avoid Breaking Changes to Your API, Communicate Changes
    to Developers

    annette_g: I did a lot of re-write, but let's discuss it later
    ... I need opinions on how to test
    ... sthg like 'send email to developers' would be really
    helpful?
    ... maybe scribe the actions one should take
    ... a notice on the API homepage

    riccardoAlbertoni: is DUV keeping a list of users adopting a
    dataset or distribution?
    ... perhaps the BP example could re-use part of that info in
    DUV

    hadleybeeman: finding your name in somebody else's metadata is
    a bit strange

    BernadetteLoscio: we don't have a proeprty to capture this in
    DUV
    ... it shouldn't be mandatory

    newton: annette_g maybe we can talk with SDW
    ... they have issues about APIs and examples
    ... we meet them next wednesday

    annette_g: the issue here is really how one can write a BP for
    noticing users
    ... is it covered by SDW?

    newton: not sure

    hadleybeeman: I could imagine situations like this
    ... it might as well be solved the same way as everyone else
    ... there's nothing special about spatial data.
    ... Why don't you send an email to their list and our list?

    BernadetteLoscio: examples says [cites the BP]

    <hadleybeeman> action annette to email SDW (and DWBP) to ask
    about their API work (with regard to examples for BP 10)

    <trackbot> Created ACTION-237 - Email sdw (and dwbp) to ask
    about their api work (with regard to examples for bp 10) [on
    Annette Greiner - due 2016-03-04].

    BernadetteLoscio: maybe we can use an API as example and show
    waht should be done with that API.

    annette_g: like, saying what change would break the API?

    BernadetteLoscio: yes

    annette_g: it's a great thought
    ... I was not sure we should have an example of a maintained
    example

    BernadetteLoscio: we could have a documentation page for the
    API

    annette_g: a fake documentation page?

    BernadetteLoscio: yes

    annette_g: who would build and maintain it?

    BernadetteLoscio: I don't know, but if we have real data, we
    could have a real or fake API.

    hadleybeeman: we need to show that it is practical
    ... other groups need implementations in the wild
    ... but we don't need to rely on sthg that needs to be
    maintained
    ... we just need enough code to show what we mean
    ... so that devlopers can adapt it to their case.

    BernadetteLoscio: yes

    annette_g: what can we put? An API is a system

    hadleybeeman: we're not telling people how to build their APIs,
    aren't we?

    annette_g: no, but we give ideas.

    hadleybeeman: so we're pointing to other APIs?
    ... examples on how to use this in the context of data on the
    web?
    ... We need to provide examples of the parts we're describing,
    not what others are describing

    annette_g: there is no spec

    hadleybeeman: is there any normative references to REST work?

    annette_g: ref to functioning APIs or work about how to create
    them?

    hadleybeeman: looking at BP21
    ... it's becoming complicated now.

    <laufer> I cannot hear anybody now...

    <annette_g> me neither

    <BernadetteLoscio> me neither

    <annette_g> restart the call?

    <deirdrelee> sound gone, i'm talking away

    <hadleybeeman> Maybe WebEx has crashed? I can't seem to rejoin
    the call

    <Caroline> me neither

    <hadleybeeman> Wait, now I'm back in.

    <laufer> neither me

    <annette_g> just finally got audio connected

    hadleybeeman: I'm suggesting that Annette has a go at putting
    down what a developer should have in mind as a bare minimum
    ... when they're implementing this
    ... instinctively
    ... (that's about the BP for making changes)

    annette_g: I really like BernadetteLoscio 's suggestion

    hadleybeeman: as you wish

    <laufer> again...

    <riccardoAlbertoni> no sound again..

    <annette_g> no

    <laufer> it is a ghost...

    <Caroline> no audio :(

    <hadleybeeman> Right. Well, I was saying — we have 8 mins left.

    <annette_g> *holy cow, tempus fugit

    <newton> @annette_g we're thinking in put all BPs related to
    APIs into a subsection under Data Access.

    <hadleybeeman> I suggest we leave the BP table for now — but it
    would be great if everyone working on the rest of the BPs make
    an effort to complete the table by next week

    <hadleybeeman> (since we're already a week overdue)

    <annette_g> yes, I want to see them all together, with the one
    about having an API in the first place coming first

    newton: can we avoid huge changes in the document at this
    stage?

    <newton> @annette_g the APIs BP will be "Data Access API"

    <laufer> I have raised an issue about the BPs I am reviewing

    sorry I meant @newton

    <hadleybeeman> okay ———— hang on please

    <hadleybeeman> Let's finish this meeting here on IRC

    <hadleybeeman> a) as above: I suggest we leave the BP table for
    now — but it would be great if everyone working on the rest of
    the BPs make an effort to complete the table by next week

    <hadleybeeman> (since we're already a week overdue)

    <annette_g> Could we have a section called "Data APIs"? I think
    people will want to search for that.

    <newton> @antoine we would only replace them into a subsection
    into Data Access. Won't create new ones.

    <laufer> +1 to annette

    <newton> Under Data Access section, to have a "Data Section
    API" as a subsection

    <BernadetteLoscio> yes! that's our idea!

    <newton> It will not reflect into a huge change, I would be a
    structural change

    antoine seriously object to structure change and any
    re-shuffling at the time you're asking text to 10 contributors

    <annette_g> Maybe make the change and then send around an email
    telling us you're done

    <annette_g> so we can do a pull

    <hadleybeeman> antoine, what are your concerns?

    <laufer> We have the problem of the BPs numbers...

    I'm afraid that we lose time figuring out what the impact of
    the changes are on the individual BPs

    I won't have time to figure this out

    so I won't work on my BPs

    <BernadetteLoscio> but the Data Access section needed to be
    reviewed

    <hadleybeeman> Aren't we only talking about the API BPs?

    <BernadetteLoscio> its just on the Data Access section

    <BernadetteLoscio> yes!

    review doesn't imply changes while everyone else is working on
    the doc

    <BernadetteLoscio> its just the Data Access section

    <riccardoAlbertoni> +1 to antoine, laufer ..

    <BernadetteLoscio> Data vocabularies section wont be affected

    <hadleybeeman> antoine, if their changes won't affect the areas
    you're looking at... Does it matter?

    At a minimum *Zero* BP numbers should change

    <annette_g> things are going to be changing if multiple people
    are editing anyway

    <Caroline> @antoine, I don't think this would stop you working
    in your BPs, it would be only putting APIs' together

    <BernadetteLoscio> we're gonna make the merge

    <BernadetteLoscio> on github

    <annette_g> I still think APIs deserve their own section

    <hadleybeeman> Re BP numbers, I'd suggest putting a temporary
    header on any merged ones that say, for example, "BP 10 and
    21."

    <BernadetteLoscio> we're gonna review the numbers when
    necessary

    <hadleybeeman> we can renumber at the very end

    <BernadetteLoscio> yes

    <newton> +1 to hadleybeeman suggestion

    <hadleybeeman> antoine, does that work for you?

    <annette_g> All the static, unwebby stuff in our doc gets so
    much text and multiple sections; I think we need to give the
    dynamic stuff fair treatment

    I'm ok with renumbering at the very end. Just please don't pull
    the carpet under our feets while we're working.

    <laufer> I agree that APIs deserve a section but we have to be
    careful in changing the BPs order now...

    <hadleybeeman> Totally fair.

    <hadleybeeman> Okay — we're out of time.

    <newton> We can track every change and show which BP Numbers
    has changed

    <hadleybeeman> You all are champions for continuing this
    without sound!!

    I don't have the time to follow your tracking

    <BernadetteLoscio> we wont change the structure of the
    document, its just the Data Access section

    <annette_g> when moving things around, that is the time to
    re-order API BPs

    <BernadetteLoscio> mainly API BP

    <Caroline> thank you @antoine and @laufer for this concern, we
    will work on it

    <laufer> Well, in this way we do not need a scribe... it is an
    advantage...

    <hadleybeeman> @newton, I think it might keep everything more
    sensible now to keep all the numbers as they are, even if they
    end up in the wrong order or multiple numbers for one BP.

    <hadleybeeman> True, laufer :)

    <laufer> bye antoine...

    <BernadetteLoscio> we dont refer to numbers in our document

    <hadleybeeman> We will, I promise, make sure it's all lovely
    and pretty (with numbers in order!) before it goes out to the
    public.

    <BernadetteLoscio> we always refer to the title of the BP

    <BernadetteLoscio> to the identifier

    <annette_g> I find it awkward that the idea of having a API at
    all comes so late. It seems strange to start telling people how
    to make an API first and then come back to that fundamental
    point

    <hadleybeeman> True, BernadetteLoscio — but we do in our
    actions/issues and notes.

    <newton> We will do it in a different branch or repository, and
    if the group agrees, we will merge it to the main document

    <BernadetteLoscio> the number is created automatically

    <hadleybeeman> that's frustrating. :(

    <BernadetteLoscio> if we also use the title, then it wont be a
    problem

    <hadleybeeman> We haven't always thus far, which is part of the
    issue.

    <hadleybeeman> I think we need to keep them for the moment, if
    we can -- even if it ends up being an extra bit of text

    <BernadetteLoscio> but just BP abou Data Access and APIs will
    change

    <Caroline> we will do our best to not get in the way of what
    authors have been working on

    <BernadetteLoscio> others will keep the same

    <BernadetteLoscio> the order of the rest wont change

    <hadleybeeman> That sounds great, Caroline. Please do that, for
    now.

    <annette_g> others will be renumbered, though

    <annette_g> because BP 10 has to move

    <BernadetteLoscio> ah ok

    <Caroline> if we see that this change may get in someone's way,
    we will wait to do it at the end. Would that be okay @annette?

    <annette_g> sure, as long as we do it

    <Caroline> great! Thank you! :)

    <hadleybeeman> Brilliant. I'm sorry we have to end this
    meeting!

    <BernadetteLoscio> ok! thanks!

    <BernadetteLoscio> thanks a lot!

    <hadleybeeman> Have a wonderful weekend, all. And thank you
    again for switching to text!

    <laufer> I will send and e-mail about the issue I raised...

    <newton> @annette_g I have some other issues to talk to you,
    may we have a call early next week to talk about it?

    <hadleybeeman> Talk next week.

    <Caroline> thank you all!!

    <hadleybeeman> thanks, laufer.

    <hadleybeeman> bye for now :)

    <newton> @annette_g it's about the Content Negotiation issue

    <annette_g> @Newton, sure, want to use Skype?

    <riccardoAlbertoni> good weekend !!

    <newton> @annette_g yes, Skype :-)

    <annette_g> yay!

    <Caroline> :))))

    <annette_g> @newton, let's exchange email to coordinate

    <newton> @annette_g ok, thanks :)

    <annette_g> okay, bye!

    <hadleybeeman> trackbot, end meeting

Summary of Action Items

    [NEW] ACTION: antoine to review the voc aspect of BP9 [recorded
    in [15]http://www.w3.org/2016/02/26-dwbp-minutes.html#action02]
    [NEW] ACTION: newton to review annette's test for BP8 [recorded
    in [16]http://www.w3.org/2016/02/26-dwbp-minutes.html#action01]

      [15] http://www.w3.org/2016/02/26-dwbp-minutes.html#action02
      [16] http://www.w3.org/2016/02/26-dwbp-minutes.html#action01

Summary of Resolutions

     1. [17]accept https://www.w3.org/2016/02/19-dwbp-minutes

    [End of minutes]
      __________________________________________________________

Received on Friday, 4 March 2016 14:17:22 UTC