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

Re: Which URI should we use in our examples?

From: Annette Greiner <amgreiner@lbl.gov>
Date: Fri, 29 Apr 2016 11:28:18 -0700
To: Bernadette Farias Lóscio <bfl@cin.ufpe.br>, Phil Archer <phila@w3.org>
Cc: "public-dwbp-wg@w3.org" <public-dwbp-wg@w3.org>
Message-ID: <5723A7C2.3020908@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 
> <mailto: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 <tel:%2B44%20%280%297887%20767755>
>     @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
Received on Friday, 29 April 2016 18:28:52 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:39:50 UTC