w3c / epubweb

White Paper on the EPUBWEB project
31 stars 10 forks source link

Issues by Dave Pawsons #35

Open iherman opened 9 years ago

iherman commented 9 years ago

(Reproduced from email with authorization)

Terminology could do with a glossary

No overall goal? See 2. for possibility " this effort will provide an open, non-proprietary, portable document format"

'Bright line distinctions' - could be clearer? Suggest different categories.

'or on-demand use of their distinguishing characteristics' suggest 'separate' characteristics

' People with technical expertise by anyone other than information technology departments were not previously required in traditional publishing workflows. ' Requires clarification?

'in case the data is too large to be distributed offline' Is this a proposed feature? Very useful for small memory devices, would be a worthwhile goal IMHO.

'as well complex administrative' s/well/well as/

Complex user manuals. A requirement is strict vsn control. Optional feature perhaps?

2.5 No mention of variant screen size? How to address 32" flat screen and 4" mobile issues? Making content flexible enough to be usable on both, or address this issue in the case of non-scalability? I note 2.8 intimates this but reality is that this is not always the case.

2.7 The archival of s/archival/archiving/

Issue: Elephant in the room? Google books, Kindle etc? Possible major users, not mentioned? Hinted at in 3.6

Section 3 reads very well!

3.3 may be very hard! No mention of learning from xlink, xpointer, SGML architectural documents.

3.7 Very important for me as a user.

Summary. An excellent start gentlemen. I wish you well. If I can help further, please ask.

Best wishes.

Dave Pawson XSLT XSL-FO FAQ. Docbook FAQ. http://www.dpawson.co.uk

mgylling commented 9 years ago

Added a set of fixes for this issue (list below). We need to figure out if there is more work to do in terms of definitions and acronym expansions before we can close. I don't have a problem with the current state in this regard, but I've been wrong before...

https://github.com/w3c/epubweb/commit/e1f58bc5b3f95b4ba00c9c99c9868ffb6327803b https://github.com/w3c/epubweb/commit/8cb18ec05e8af8daea3e803b18c9112fe350967c https://github.com/w3c/epubweb/commit/64750ae7fcefa4a4bd3b4d37e15dfbcdb8fb1980 https://github.com/w3c/epubweb/commit/0801e5c32d2ad4b41cfeb220ec1585e4f2242e00

iherman commented 9 years ago

I am fine with the changes; as for the glossary, I would propose we wait until issue #4 (the naming of the whole thing) is resolved, because that may lead other changes in terms of terminology...