TODO.md

New structure after PWP-UCR reorg

These are notes of reorganizing the PWP draft. These notes are related to a version of the PWP draft that has already been reduced and changed (in a separate branch) compared to the 'official' document as a result of the earlier work on UCR-s in spring an early summer. But the current UCR reorganization requires an even more thorough change on the PWP draft; this is just first, initial idea.

The proposal is based on the first reorganized version:

https://rawgit.com/w3c/dpub-pwp/sync-with-ucr/index.html

done in spring. What is below is, essentially, a table of content with some hints on what the corresponding section contains.

1. The vision of Publishing on the Web
   1. High level vision (current text to be reviewed)
   2. Technical vision (current text should be reduced)
2. Why work on this now
3. Terminology
   1. Web Publication (mostly like in the ucr document)
   2. Packaged Web Publication (mostly like in the ucr document)
   3. Manifests (mostly like in the ucr document)
   4. Locators (?)
4. Some Technical Challenges
   1. Web Publications
      1. Web Locator of a WP
         • what do I get from a HTTP GET?
      2. Manifests
         • relationships to Web Manifests
         • additional terms v.a.v. Web Manifests, eg, alternative reading order
         • reaching out to external metadata
         • locating a web manifest
      3. Additional APIS (possibly)
         • Document Collection API on top of the DOM?
         • Publication Object Model & API?
      4. Online/offline
         • notion of an (abstract) WP Processor and its role
         • role of Service Workers, and possible problems/challenges/deficiencies thereof
      5. Personalization issues
      6. Pagination and other Styling and Layout problems
   2. Packaged Web Publications
      1. Packaging formats, relationship to Web Packaging
      2. Canonical locator mapping
5. Profiling (P)WP-s?
   • introduction of profiles to accommodate various user communities...
6. (P)WP and EPUB4