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

The primary entry page may be under specified #329

Closed
llemeurfr opened this issue Sep 6, 2018 · 4 comments
Closed

The primary entry page may be under specified #329

llemeurfr opened this issue Sep 6, 2018 · 4 comments
Assignees

Comments

@llemeurfr
Copy link
Contributor

From reading the specification, it is difficult to have an idea about what the primary entry page is made for.

It's introduced in 3.5 resources as the only required resource in a WP.
In 3.6 we discover that the ToC should be located there (if not the manifest should reference it). This is detailed in 4.6.2.
In 4.3.2 we discover that the Web Publication address is the URL of this resource (but 4.3.2.1 states that it may not be an HTML resource, in which case the user should not have access to it (SVG forbidden)).
In 4.3.5 we see that it can have some influence on the language and base direction of the WP, and in 4.3.9 that the title of the WP may be inferred from it.

I wonder if such an important piece of information for WP should have its specification grouped in a specific section (in 3.5 ?).

@iherman
Copy link
Member

iherman commented Sep 6, 2018

I see the point, I have actually hit this issue at some point; it is an important concept and its role is scattered over the document. Yes, it may be better to regroup things at one place.

@mattgarrish ?

@mattgarrish
Copy link
Member

I actually thought we had a section on it, but I probably just got confused by all the bikeshedding about the name we did. Certainly seems useful to detail it under the construction section.

@mattgarrish
Copy link
Member

Can this be closed now @llemeurfr? It should be addressed with #335.

@llemeurfr
Copy link
Contributor Author

@mattgarish yes let's close it, the new section is a really good start. Thanks.

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

No branches or pull requests

3 participants