W3C home > Mailing lists > Public > public-sdw-wg@w3.org > February 2016

Preparation ahead of this week's call: reviewing DWBP doc

From: Jeremy Tandy <jeremy.tandy@gmail.com>
Date: Sat, 13 Feb 2016 15:08:49 +0000
Message-ID: <CADtUq_1Z00CizXKUftemGNRut6YO81_W2xJbwnjKj6ZDFPW3aQ@mail.gmail.com>
To: SDW WG Public List <public-sdw-wg@w3.org>
This week we'll be joined by folks from the DWBP working group. As you
know, the SDW best practices often build on those defined in DWBP, so it's
important to make sure we have clear and well understood relationship
between the two sets of best practices.

At this week's F2F meeting in Amersfoort, @eparsons asked me to remind you
all about your homework: please *read the DWBP editor's draft* [1] ...

   - look see if they are handling location / spatial / temporal issues
   well where ever they are referenced or used as examples in their best
   practices
   - spot the gaps with our expectations regarding “common” data on the web
   (i.e. issues that don't relate purely to location / spatial); we will need
   to clarify position with DWBP … but note that @phila says that they're
   sufficiently progressed so that if they haven’t covered these issues they
   won't be going into the DWBP doc! If those issues are important to us we
   _must_ include these in our BP doc.
   - best to read the whole thing, but prioritise attention on those best
   practices we are explicitly referencing ...
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 4
      Provide structural metadata
      <http://w3c.github.io/dwbp/bp.html#StructuralMetadata> (
      http://w3c.github.io/dwbp/bp.html#StructuralMetadata)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 7:
      Provide data quality information <http://www.w3.org/TR/dwbp/#quality>
       (http://www.w3.org/TR/dwbp/#quality)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 8:
      Provide versioning information
      <http://www.w3.org/TR/dwbp/#VersioningInfo> (
      http://www.w3.org/TR/dwbp/#VersioningInfo)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 10:
      Use persistent URIs as identifiers
      <http://www.w3.org/TR/dwbp/#UniqueIdentifiers> (
      http://www.w3.org/TR/dwbp/#UniqueIdentifiers)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 11:
      Use persistent URIs as identifiers within datasets
      <http://w3c.github.io/dwbp/bp.html#identifiersWithinDatasets> (
      http://w3c.github.io/dwbp/bp.html#identifiersWithinDatasets)
      - [DWBP]  Best Practice 12 Use persistent URIs as identifiers within
      datasets <http://www.w3.org/TR/dwbp/#identifiersWithinDatasets> (
      http://www.w3.org/TR/dwbp/#identifiersWithinDatasets)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 15 Use
      standardized terms
      <http://w3c.github.io/dwbp/bp.html#MetadataStandardized> (
      http://w3c.github.io/dwbp/bp.html#MetadataStandardized)
      - [DWBP] Best Practice 16 RE-use vocabularies
      <http://w3c.github.io/dwbp/bp.html#ReuseVocabularies> (
      http://w3c.github.io/dwbp/bp.html#ReuseVocabularies)
      - [DWBP] Best Practice 17 Choose the right formalization level
      <http://w3c.github.io/dwbp/bp.html#ChoseRightFormalizationLevel> (
      http://w3c.github.io/dwbp/bp.html#ChoseRightFormalizationLevel)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 20:
      Provide bulk download <http://w3c.github.io/dwbp/bp.html#BulkAccess> (
      http://w3c.github.io/dwbp/bp.html#BulkAccess)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 21:
      Use Web Standardized Interfaces
      <http://w3c.github.io/dwbp/bp.html#APIHttpVerbs> (
      http://w3c.github.io/dwbp/bp.html#APIHttpVerbs)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 22:
      Serving data and resources with different formats
      <http://w3c.github.io/dwbp/bp.html#Conneg> (
      http://w3c.github.io/dwbp/bp.html#Conneg)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 25:
      Document your API <http://w3c.github.io/dwbp/bp.html#documentYourAPI>
      . (http://w3c.github.io/dwbp/bp.html#documentYourAPI)
      - [DWBP <http://w3c.github.io/sdw/bp/#bib-DWBP>] Best Practice 26:
      Use an API <http://w3c.github.io/dwbp/bp.html#useanAPI> (
      http://w3c.github.io/dwbp/bp.html#useanAPI)

(note that some of the DWBP numbers might now be out of sync with our
references)

Most relevant sections to look at in the DWBP doc are:

   - 7.2 Metadata <http://w3c.github.io/dwbp/bp.html#metadata>
   - 7.7 Data Identifiers
   <http://w3c.github.io/dwbp/bp.html#DataIdentifiers>
   - 7.9 Data Vocabularies
   <http://w3c.github.io/dwbp/bp.html#dataVocabularies>
   - 7.11 Data Access <http://w3c.github.io/dwbp/bp.html#dataAccess>

Best regards, Jeremy

[1]: http://w3c.github.io/dwbp/bp.html
Received on Saturday, 13 February 2016 15:09:28 UTC

This archive was generated by hypermail 2.4.0 : Thursday, 24 March 2022 20:31:20 UTC