Re: [Glossary] Definition of a portable document (and other things...)

Good morning/afternoon

here is your friendly daily summary:-) to start the next round. Maybe the last? (That would be a good way to close the week-end:-)

As far as I am concerned, the most important outcome of the last round is the recognition that we may mix the definition of the various documents and their states. I fully agree with Tzviya that we should separate the details of that discussion for a separate thread; just to build the bridge to that thread I believe that:

 - We (will:-) have the notion of a Portable Web Document
 - A Portable Web Document may be in an online, cached, or offline state

It is of course true that a (not necessarily portable) Web Documents may also be in a cashed state, for example. Also, as was discussed on the thread, a general Web Document may be transformed into a Portable Web Document (e.g., dumping its snapshot into a PDF file), but I would think that this is not the subject of discourse for this Interest Group which, after all, "just" wants to set up a framework for Digital Publishing and the Web, ie, EPUB+WEB. We should limit ourselves in our discussion…

With that… getting back to the issue at hand, ie, the definitions. As a reminder, I reproduced the previous definition below (after my signature). Well, the remaining issue, of course, was to define what exactly the portability is. After looking at Bill's and Deborah's formulations, I was more inspired by the latter (sorry Bill…) but, I believe and as Bill said, we are really at the word-smithing stage here. So here it goes:

[[[
• A Web Resource is a ... (see the current glossary [1])

• Web Document is a ... (see the current glossary [1])

• A Web Resource in a Web Document is Portable if an OWP compliant user agent can render its essential content by relying exclusively on the Web Resources within the same Web Document.

• A Portable Web Document is a Web Document whose all constituent Web Resources are Portable.
]]]

I have refreshed [1] to reflect the whole definition.

How does that sound? Is this an acceptable consensus?

Ivan

P.S. Once we have the discussion closed it is probably useful to provide some explanatory text and, especially, to collect and document the various examples we had in the discussion. They will be very useful in explaining the terms. I am happy to do that once we are done…

P.S.2. This terminological discussion may also influence the way we formulate the next release of the EPUB+WEB document. Actually, this was one of the issues that triggered me to start this thread...


[1] https://www.w3.org/dpub/IG/wiki/Glossary <https://www.w3.org/dpub/IG/wiki/Glossary>

----
Ivan Herman, W3C
Digital Publishing Lead
Home: http://www.w3.org/People/Ivan/
mobile: +31-641044153
ORCID ID: http://orcid.org/0000-0003-0782-2704

Here is the previous version:

• A Portable Web Document: a Web Document which contains, within its constituent set, the information necessary to provide delivery of essential content and functionality, or a graceful degradation thereof, without the presence of any other Web Resources.

 • It must be possible to present the essential content of a Portable Web Document even if it is offline (though possibly with a lower quality, e.g., using suboptimal, but local fonts, or images instead of a remote video).

 • Active processes (e.g., scripts) of a Portable Web Document, when responsible for an essential functionality, must not depend on Web Resources external to the Portable Web Document.