Skip to content

Simplifying the Foreign Resource Section #2894

@sueneu

Description

@sueneu

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

No one assigned

    Labels

    Spec-EPUB3The issue affects the core EPUB 3.X Recommendation

    Type

    No type

    Projects

    Status

    In review

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions