W3C home > Mailing lists > Public > public-dwbp-wg@w3.org > May 2016

Re: Which URI should we use in our examples?

From: Bernadette Farias Lóscio <bfl@cin.ufpe.br>
Date: Tue, 3 May 2016 09:37:43 -0300
Message-ID: <CANx1PzzeMaZegZLvMWM_SpdYemNNZQjXUKeYpXF6xMQ+N3mrfw@mail.gmail.com>
To: Annette Greiner <amgreiner@lbl.gov>
Cc: Phil Archer <phila@w3.org>, "public-dwbp-wg@w3.org" <public-dwbp-wg@w3.org>
Hi all,

I just updated the URI used in our examples (commits [1] and [2]).

Please take a look to check if the examples that you provided are still ok!

Thanks!
Berna

[1]
https://github.com/w3c/dwbp/pull/378/commits/152af52fda80a0ac43faf80acf806c9d9c4670ef
[2]
https://github.com/w3c/dwbp/pull/378/commits/50b9a9c47d05adf0e26bc34cc4e6429d20526b2f



2016-04-29 15:28 GMT-03:00 Annette Greiner <amgreiner@lbl.gov>:

> Yes, I'm okay with that.
> -Annette
>
>
> On 4/29/16 6:56 AM, Bernadette Farias Lóscio wrote:
>
> Hi Annette,
>
> @Annette and Phil, thanks a lot for the great help!
>
> I'd like to know if we can change the document to use one of the URIs
> proposed by Phil.
>
> We propose to use:
> http://data.mycity.example.com/transport/dataset/bus/stops
>
> kind regards,
> BP Editors
>
> 2016-04-27 14:15 GMT-03:00 Phil Archer <phila@w3.org>:
>
>> Annette,
>>
>> I can live with removing /roads and /bus. Would you be happy with
>> http://data.mycity.example.com/transport/dataset/bus/stops
>>
>>
>> This makes it clear to a human reader that the URI identifies a dataset
>> rather than a bus stop, or a concept. The transport and dataset path
>> elements could be swapped to give
>>
>> http://data.mycity.example.com/dataset/transport/bus/stops - I don't
>> feel strongly either way.
>>
>> Phil.
>>
>>
>>
>>
>>
>> On 26/04/2016 21:52, Annette Greiner wrote:
>>
>>> I can live with "dataset" as a placeholder for a real identifier for the
>>> dataset, if "/road" and "bus-" come out. We should not be suggesting
>>> people build long, redundant URIs. That is not a best practice.
>>> It's not clear to me whether you are thinking that all datasets
>>> published by the transport agency would have /dataset near the end of
>>> the path. That would not be a good idea for a RESTful API, because it
>>> would complicate the regular expressions that filter out the various
>>> requests. You want to be able to chop off a base URI and work on the
>>> stuff that decides the response.
>>> -Annette
>>>
>>> On 4/26/16 11:16 AM, Bernadette Farias Lóscio wrote:
>>>
>>>>
>>>> Dear Annette and Phil,
>>>>
>>>> We're trying to resolve the comments about the Data Identifiers
>>>> section, but some comments still need further discussion. We'd like to
>>>> ask your help in order to resolve the following one [2]:
>>>>
>>>> *** Comment 17 (Item 3) Persistent URIs as identifiers [1]
>>>>
>>>> There is no consensus about the URI that we should use in our examples.
>>>> Annette made the following proposal:
>>>>
>>>> --------------------
>>>> I think we could go with something like this:
>>>>
>>>> http://data.mycity.example.org/transport/ is a base for all the
>>>> example URIs
>>>> Probably a real link would need to identify the dataset somehow rather
>>>> than just say that it's a dataset.
>>>> What do you think about this?
>>>> http://data.mycity.example.org/transport/timetables/bus/stops/ "
>>>> ---------------------
>>>>
>>>> We prefer to use the one initially proposed by Phil:
>>>>
>>>> http://data.mycity.example.com/public-transport/road/bus/dataset/bus-stops
>>>>
>>>>
>>>> Maybe we can use just "transport" rather than "public-transport", but
>>>> we should keep dataset rather than timetables.
>>>>
>>>>
>>>> What do you think?
>>>>
>>>> Thanks,
>>>> BP Editors
>>>>
>>>>
>>>>
>>>>
>>>> [1]
>>>> https://lists.w3.org/Archives/Public/public-dwbp-wg/2016Apr/0157.html
>>>> [2]
>>>>
>>>> https://www.w3.org/2013/dwbp/wiki/Comments_to_be_considered_before_publishing_the_last_working_draft
>>>>
>>>>
>>>>
>>>> --
>>>> Bernadette Farias Lóscio
>>>> Centro de Informática
>>>> Universidade Federal de Pernambuco - UFPE, Brazil
>>>>
>>>> ----------------------------------------------------------------------------
>>>>
>>>>
>>>
>> --
>>
>>
>> Phil Archer
>> W3C Data Activity Lead
>> http://www.w3.org/2013/data/
>>
>> http://philarcher.org
>> +44 (0)7887 767755
>> @philarcher1
>>
>
>
>
> --
> Bernadette Farias Lóscio
> Centro de Informática
> Universidade Federal de Pernambuco - UFPE, Brazil
>
> ----------------------------------------------------------------------------
>
>
> --
> Annette Greiner
> NERSC Data and Analytics Services
> Lawrence Berkeley National Laboratory
>
>
>


-- 
Bernadette Farias Lóscio
Centro de Informática
Universidade Federal de Pernambuco - UFPE, Brazil
----------------------------------------------------------------------------
Received on Tuesday, 3 May 2016 12:38:31 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 3 May 2016 12:38:32 UTC