-
Notifications
You must be signed in to change notification settings - Fork 64
Description
Section
https://www.w3.org/TR/epub-34/#sec-foreign-resources
Describe the problem
I believe we can simplify the Foreign Resource text and retain the concepts.
Why? Sometimes people referring to our documents are stressed, like when troubleshooting an EPUB that isn’t working as expected. I have personal experience with this. In some cases, reading in English may present a challenge. In most cases, readers will not be as familiar with the documents and concepts as we are. So we should simplify where we can on this complex specification.
Describe the fix or new feature you propose
I propose we edit this
3.3 Foreign resources
A foreign resource, unlike a core media type resource is one which is not guaranteed reading system support when used in an EPUB content document or foreign content document.
Fallbacks MUST be provided for foreign resources, where fallbacks take one of the following forms:
To shorter sentences without any parentheticals.
3.3 Foreign resources
A foreign resource can be used in an EPUB content document or foreign content document. However, unlike a core media type resource, a foreign resource is not guaranteed reading system support.
Fallbacks MUST be provided for foreign resources. Fallbacks take one of the following forms:
Metadata
Metadata
Assignees
Labels
Type
Projects
Status