Re: Final Linked Data Glossary (was Re: def'n of resource?)

 Hi Sandro,

This looks fine, and all the terms mentioned in the description are also
explained in the glossary. So, self-contained as well.


Regards,
--Biplav










                                                                                                                                   
  From:       Sandro Hawke <sandro@w3.org>                                                                                         
                                                                                                                                   
  To:         Bernadette Hyland <bhyland@3roundstones.com>                                                                         
                                                                                                                                   
  Cc:         W3C public GLD WG WG <public-gld-wg@w3.org>                                                                          
                                                                                                                                   
  Date:       23/05/2013 08:30 AM                                                                                                  
                                                                                                                                   
  Subject:    Re: Final Linked Data Glossary (was Re: def'n of resource?)                                                          
                                                                                                                                   





On 05/22/2013 07:12 AM, Sandro Hawke wrote:
      In general, the glossary is great, but the current text on 5 star is
      not okay.

      I can live with dropping it (for now), or just pointing to Tim's
      page, but not the current definition which never even mentions RDF.
      Sorry.


Bernadette asked me to make another suggestion for the wording.  I can see
how my earlier suggestions were a bit verbose for this context.

First, a reminder what Tim says 4-stars and 5-stars mean:

4:  RDF Standards
5:  Linked RDF

That's a little terse (so it could fit on the mug).  As a middle ground how
about:

4: Publish data on the Web as RDF (eg Turtle, RDFa, JSON-LD, SPARQL)
5: In your RDF, have the identifiers be links (URLs) to useful data sources

Okay?   Can we live with that?

      -- Sandro



 Bernadette Hyland <bhyland@3roundstones.com> wrote:
            Hi,
            Remaining feedback folded in especially in relation to
            definition of
            "Resource", addition of "Web Resource" and fixing 5 star LOD
            definition.  Also updated normative references in doc.

            Linked Data Glossary Draft 21-May 2013 [1] is ready for
            publication
            once run through one last PubRules check.  (Last week the WG
            approved
            to publish as a WG Note.)

            NB:  Editorial changes are to keep tone consistent with rest of
            the
            document, however were not intended to alter the proposed
            meaning.  If
            this unintentionally happened, please notify asap.  Reference
            to RFC
            3986 was made elsewhere so I dropped from below proposal so as
            to not
            sound repetitive.

            Again, we're striving for simplicity and for this to be a
            glossary of
            terms for Web developers, not the anointed per se.

            All OK now per your feedback??

            -----%<-------
            90. Resource

            In an RDF context, a resource can be anything that an RDF graph
            describes. A resource can be addressed by a Unified Resource
            Identifier
            (URI). See also Resource Description Framework (RDF) 1.1
            Concepts and
            Abstract Syntax [RDF11-CONCEPTS]


            127. Web Resource

            A web page addressed by a URL. Examples include: an HTML web
            page, an
            image offered by a web server, or a dataset accessible by a
            URL. A Web
            Resource may have different representations. For example, an
            RDF
            database might be accessed at a single URL using multiple
            syntaxes,
            such as RDFa, JSON-LD, and Turtle. See also Hypertext Transfer
            Protocol
            HTTP/1.1 [RFC2616].


            Cheers,
            Bernadette Hyland

            [1]
            https://dvcs.w3.org/hg/gld/raw-file/default/glossary/index.html


            On May 8, 2013, at 5:48 AM, Dave Reynolds
            <Dave.e.Reynolds@gmail.com>
            wrote:


                  On 08/05/13 05:39, Bernadette Hyland wrote:

                        Hi Sandro,
                        The editors have folded in all comments received in
                        relation to the

            LD

                        Glossary.  Please see latest version. [1]

                        For Thursday's telecon, would you create a diff
                        previously approved

            for

                        publication (April) & the May 7th (current).  Also,
                        need a new
                        Overview.html file run through PubRules.  I'm done
                        until we get

            further

                        feedback.  Thanks for your help on this.
                        ---

                        Regarding "Resource", I've simplified to include
                        only one

            definition.

                         In keeping with my new mantra, "keep it simple",
                        how does this this
                        sit with you & others?


                  Personally I prefer Sandro's suggestion. I imagine that
                  at least some

            people reading the glossary will be aware of the notion of REST
            and
            might expect something more like the entry for Web Resource.
            Having
            both solves that problem.


                  However, it's not something I would argue strongly over.

                  Dave




                           89. Resource

                        In an RDF context, a resource can be anything that
                        an RDF graph
                        describes. A resource can be addressed by a Unified
                        Resource

            Identifier

                        (URI)


            <https://dvcs.w3.org/hg/gld/raw-file/default/glossary/index.html#uniform-resource-identifier>
            .




                        Keep in mind that this LD Glossary is a starting
                        point for those new

            to

                        Linked Data.  We don't want to scare people, it is
                        the 'welcome

            basket'

                        not the definitive guide for the working LD expert
                        (which is found
                        elsewhere on the W3C site).

                        Cheers,
                        Bernadette

                        [1]
                        https://dvcs.w3.org/hg/gld/raw-file/default/glossary/index.html


                        Sandro wrote:

                              I've thought about more than most people have
                              thought about food


                        PS.  Clearly you haven't met my 15 year old son who
                        pretty much only
                        thinks about food ;-)


                        On May 7, 2013, at 7:15 PM, Sandro Hawke <
                        sandro@w3.org
                        <mailto:sandro@w3.org>> wrote:


                              def'n of resource?
                              Bernadette and I were working on actually
                              publishing the Glossary,
                              which the group approved for publication, and
                              I noticed a little

            problem:



                                     86. Resource

                                 A resource is anything that can be
                              addressed by a Unified

            Resource

                                 Identifier (URI)


            <file:///home/sandro/Repos/gld/glossary/diff.html#uniform-resource-identifiers>
            .



                                 ...


                                     93. Resource

                                 A resource is a network data object or
                              service that can be
                                 identified by an HTTP URI. Resources may
                              be available in

            multiple

                                 representations (e.g. multiple languages,
                              data formats, size,

            and

                                 resolutions) or vary in other ways. See
                              details from RFC 2616bis
                                 for details on Uniform Resource
                              Identifiers. See details from

            RFC

                                 2616bis for details on Uniform Resource
                              Identifiers.

                              The definition of Resource is something I've
                              thought about more

            than

                              most people have thought about food.  I
                              suggest we call the second

            one

                              "Web Resource", and explain, like this:


                                 *Resource*

                                 (Not to be confused with _Web Resource_)
                              An entity.   Saying

            that

                                 something is a resource says nothing at
                              all about it, because by
                                 the definition of the term, everything is
                              a resource.    For

            more

                                 details see Uniform Resource Identifier
                              (URI): Generic Syntax

            (RFC

                                 3986) [1] and Resource Description
                              Framework (RDF) 1.1 Concepts

            [2].



                                 *Web Resource*

                                 Anything which is addressed by a URL;
                              roughly speaking, a web
                                 page.  Examples include: an HTML web page,
                              an image offered by a
                                 web server, or a dataset available for
                              access at some URL.   A
                                 resource may change its state over time
                              and have different
                                 representations of the same state.  For
                              example, a webcam might
                                 offer both JPEG and PNG versions of its
                              current image, at the

            same

                                 URL, using content negotiation, or an RDF
                              database might be
                                 accessed at one URL using multiple
                              syntaxes, such as RDFa,
                                 JSON-LD, and Turtle.   For more details
                              see Hypertext Transfer
                                 Protocol -- HTTP/1.1 [3]

                                 Sometimes Web Resources are just called
                              "Resources".  In some
                                 contexts, this can cause unnecessary
                              confusion.  The difference

            is

                                 related to the distinction between URLs
                              (which identify Web
                                 Resources) and URIs (which identify
                              Resources in general), as
                                 discussed in
                              http://tools.ietf.org/html/rfc3305#page-3

                                 [1] http://tools.ietf.org/html/rfc3986
                                 [2]

            http://www.w3.org/TR/rdf11-concepts/#resources-and-statements

                                 [3]


            http://www.w3.org/Protocols/HTTP/1.1/rfc2616bis/draft-lafon-rfc2616bis-04.html#intro.terminology



                              I hope that works for folks.    Bernadette
                              made some other changes,

            so

                              we're going to ask the WG for approval again
                              before publishing.

            I'll

                              be sending along a pointer to the new version
                              and the diffs once I
                              have it passing pubrules.

                                      -- Sandro

Received on Thursday, 23 May 2013 03:39:16 UTC