Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

toc links #31

Closed
mattgarrish opened this issue Oct 22, 2019 · 2 comments
Closed

toc links #31

mattgarrish opened this issue Oct 22, 2019 · 2 comments

Comments

@mattgarrish
Copy link
Member

In the toc section, it says that when there is supplemental content:

the table of contents SHOULD include a link to all resources

with a pointer to the resource list, but this seems too general. If that is the case, wouldn't it have to link to any css, images, scripts, etc. to avoid warnings?

Is the intention to link to all resources in the reading order and the supplementary resources?

wareid added a commit that referenced this issue Nov 11, 2019
Addressing Matt's comments in
#30
#31
#32
#33
#34
#35
#36
@mattgarrish
Copy link
Member Author

I see it now says:

the table of contents SHOULD include a link to any resources a user can interact with; and

But if this is just about supplemental content, that might be the simpler terminology, so something like:

"the table of contents SHOULD link to all the supplemental content; and"

There's something of an impossibility here, though, in terms of ever enforcing this. I wonder if it should be a note instead of a normative statement:

"When including supplemental content, be aware that users might not have access to this content unless it is linked to from the table of contents. It is strongly advised to provide links to all content
that is not in the default reading order."

Or something like that.

@wareid
Copy link
Contributor

wareid commented Nov 12, 2019

Modified the language slightly and included the note.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants