RE: "Completeness" as a feature of a POW (aka EPUB+Web)??

Just a quick observation wrt Ivan's example of citations to external publications (my deliberate wording). The papers cited in a journal article (often scores and sometimes hundreds of them) are NOT part of "the publication," they are referenced by the publication. The citations are part of the publication; the cited resources are not.

We need to be careful, in considering the concept of completeness, to distinguish between whether we are talking about "the publication itself" vs. "the publication and everything else it references."

This also applies to dynamic content, e.g., a link that fetches up-to-date information (a stock price, the weather in Sydney, comments from other students in my class on what we're studying, etc.).

In both of those cases, imo, it is reasonable to consider the publication complete (and, put the other way around, inappropriate to consider it incomplete) if those links/citations are present, even if they are not actionable at a given time (e.g., when the portable version of the publication is consumed offline), and whether or not the external content has been cached. This is _very_ important for publications like magazines and news publications. (Be careful to avoid reflexively thinking "books.")

--Bill K

-----Original Message-----
From: Ivan Herman [mailto:ivan@w3.org] 
Sent: Thursday, August 13, 2015 12:55 AM
To: Leonard Rosenthol
Cc: W3C Digital Publishing IG; Bill McCoy
Subject: Re: "Completeness" as a feature of a POW (aka EPUB+Web)??

Leonard,

good catch, the formulation is indeed not clear. Obviously, there is a need for external link to various things; to take the area of academic publication as an example, such a publication may include references to other papers, it may include references to research data (that may be too large to be included in the document), etc, and it is essential to keep the hyperlink nature of those references. In this sense, "completeness" is not meant to be "fully self-contained".

I think that Bill's answer[1]:

"portable documents "promise" a reliable consumption experience without respect of any particular server infrastructure and, especially, without such server infrastructure providing interactivity."

what I believe we all mean. I am not sure "idempotence"[2], proposed by Bill, is really the right term, but I do not have a better one at this point either:-(

Thanks

Ivan

[1] https://lists.w3.org/Archives/Public/public-digipub-ig/2015Aug/0056.html

[2] https://en.wikipedia.org/wiki/Idempotence



> On 13 Aug 2015, at 02:31 , Leonard Rosenthol <lrosenth@adobe.com> wrote:
> 
> In rewriting the document about Portable Documents for the web (thanks for the suggestion & link, Tzviya), I can across the following paragraph:
> 
>> EPUB can be viewed as simply defining a specialization of Web content that assures that a collection of content items has the needed properties of completeness and logical structure, and does so in a standard way that other processing tools and services can reliably create, manipulate, and present such collections. This completeness constraint is key for bridging the current gap between an online and offline/portable view of the same content (see <a href="#whynow">section on usage patterns</a> below).
>> 
> While not spelled out here or in the “section on usage patterns”, I am going to take the terminology of “completeness” to mean “fully self-contained” (aka no external references).  If it means something else, feel free to ignore what follows (but only after you correct me :).
> 
> In the current use cases for EPUB (books, magazines, etc.), the desire by the publisher to have everything contained inside the package is clearly key – just as that same property has been a tenant of the various PDF subset standards (PDF/A, PDF/X, etc.)  However, there also exists for PDF use cases where external references are a key aspect to the workflow – for example, external content or color profiles in a variable or transactional workflow (eg. PDF/VT).   As such, I would like to suggest that as a portable document for OWP, that there also needs to be a provision for external references in this POW (Portable Open Web) format.
> 
> I know that there have been discussions about this around EPUB in the past for large assets (eg. Video and audio), but I would put forth that the same principles could also be applied for other types of content as well.  Be it advertisements in a publication, current data sets in a STEM publication or even just a reference to the latest version of a common JS library used by the publication.
> 
> What do others think about this?   Is completeness/self-contained a requirement in a POW?
> 
> Thanks,
> Leonard
> 


----
Ivan Herman, W3C
Digital Publishing Activity Lead
Home: http://www.w3.org/People/Ivan/

mobile: +31-641044153
ORCID ID: http://orcid.org/0000-0003-0782-2704

Received on Thursday, 13 August 2015 15:39:46 UTC