W3C home > Mailing lists > Public > public-dxwg-wg@w3.org > September 2019

Re: [dxwg] Drop "family of documents" section from conneg (#1105)

From: Karen Coyle via GitHub <sysbot+gh@w3.org>
Date: Mon, 30 Sep 2019 00:18:25 +0000
To: public-dxwg-wg@w3.org
Message-ID: <issue_comment.created-536356301-1569802704-sysbot+gh@w3.org>
@aisaac As per 1, perhaps then there is a need to explain how it is that these documents relate to each other. Right now they are a listing of separate and separately named documents. That's far from the SPARQL example where all of the documents are in support of and part of SPARQL 1.1. It would make a difference to say how these documents support each other, because the way they are in Conneg right now they are all listed as emanating from DXWG but not presented as in support of each other. The document needs to say what is the unifying factor, and what are the dependencies, so people can know if they have to read all of them to understand any one of them. If there is no dependency then it should be made clear that they each stand alone. (Ranganathan's 4th law: Save the time of the reader.)

-- 
GitHub Notification of comment by kcoyle
Please view or discuss this issue at https://github.com/w3c/dxwg/issues/1105#issuecomment-536356301 using your GitHub account
Received on Monday, 30 September 2019 00:18:26 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 30 October 2019 00:15:58 UTC