RE: FYI: The Structural Semantics Vocabulary note has been published

> if they only appear on a very small subset of items

 

Well, to travel back in time to the IDPF days, using semantics was a common
practice in extension specs. Some semantics have modeling requirements
defined in other specifications, some don't. The "about" section was
intended to give the brief summary of what the various property fields means
so we didn't have to put notes in everywhere, as the expectation when we
started adding these extension terms was that there would be a lot more in
the future. (This note is just the latest port of the structure vocab, after
all, not something written new for W3C.)

 

Given that we've largely abandoned epub:type now, and there isn't much
interest in porting those old specifications forward, I agree there isn't
much point in keeping that particular explanation. I don't expect the
meaning of the field is ambiguous, and we should be using proper references.

 

What's there now is easily changed, as just because a note is published
doesn't mean we can't keep updating it.

 

Matt

 

From: Leonard Rosenthol <lrosenth@adobe.com> 
Sent: November 4, 2021 10:35 AM
To: Matt Garrish <matt.garrish@gmail.com>; 'W3C EPUB 3 Working Group'
<public-epub-wg@w3.org>
Subject: Re: FYI: The Structural Semantics Vocabulary note has been
published

 

Ah - thanks Matt.  I hadn't looked at Index, I was looking elsewhere in the
document.   So it looks like this these only exist for Index and Comics,
correct?   

 

So why, if they only appear on a very small subset of items, was it
necessary to put this statement up at the top of the doc - or in the doc at
all?

 

Leonard

 

From: Matt Garrish <matt.garrish@gmail.com <mailto:matt.garrish@gmail.com> >
Date: Thursday, November 4, 2021 at 9:32 AM
To: 'W3C EPUB 3 Working Group' <public-epub-wg@w3.org
<mailto:public-epub-wg@w3.org> >
Subject: RE: FYI: The Structural Semantics Vocabulary note has been
published

> There is no IDPF, none of its former specifications are referenced, and
there is no "Usage Details" section to this document.

 

The usage details are defined for various properties. For example, see
https://www.w3.org/TR/epub-ssv-11/#h_indexes
<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.w3.or
g%2FTR%2Fepub-ssv-11%2F%23h_indexes&data=04%7C01%7Clrosenth%40adobe.com%7C24
3ad27dfc824aa81afe08d99f978468%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C
637716295383290633%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luM
zIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=dCgmtPIY2IKryiv7rwnrRcfib7%2B
JCTJxdYVhuA56JRc%3D&reserved=0> 

 

They're more "fields" than "sections", granted. I expect we could strike
that sentence, though, and simply put proper references on the
specifications where they're cited (looks like only Indexes and Region-Based
Nav).

 

Matt

 

 

From: Leonard Rosenthol <lrosenth@adobe.com <mailto:lrosenth@adobe.com> > 
Sent: November 4, 2021 10:14 AM
To: Ivan Herman <ivan@w3.org <mailto:ivan@w3.org> >; W3C EPUB 3 Working
Group <public-epub-wg@w3.org <mailto:public-epub-wg@w3.org> >
Subject: Re: FYI: The Structural Semantics Vocabulary note has been
published

 

I gather it is already published, but if you could fix one thing.

 

> 1.1

> The Usage Details sections identify IDPF specifications that define or
utilize the specified properties.

 

There is no IDPF, none of its former specifications are referenced, and
there is no "Usage Details" section to this document.

 

Leonard

 

From: Ivan Herman <ivan@w3.org <mailto:ivan@w3.org> >
Date: Thursday, November 4, 2021 at 6:36 AM
To: W3C EPUB 3 Working Group <public-epub-wg@w3.org
<mailto:public-epub-wg@w3.org> >
Subject: FYI: The Structural Semantics Vocabulary note has been published

See https://www.w3.org/TR/epub-ssv-11/
<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.w3.or
g%2FTR%2Fepub-ssv-11%2F&data=04%7C01%7Clrosenth%40adobe.com%7C243ad27dfc824a
a81afe08d99f978468%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637716295383
300601%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6I
k1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=ipGZDwNt%2F%2FzztjXN1NjvUP81vfMvaTA1QHAKu
YWVQ4w%3D&reserved=0> 

 

Ivan


----
Ivan Herman, W3C 
Home: http://www.w3.org/People/Ivan/
<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.w3.org
%2FPeople%2FIvan%2F&data=04%7C01%7Clrosenth%40adobe.com%7C243ad27dfc824aa81a
fe08d99f978468%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C6377162953833105
47%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
WwiLCJXVCI6Mn0%3D%7C1000&sdata=8IHCkdwEooMmFmAbZXPWaikwmN83DvhMYBocxwDbDow%3
D&reserved=0> 
mobile: +33 6 52 46 00 43
ORCID ID: https://orcid.org/0000-0003-0782-2704
<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Forcid.org
%2F0000-0003-0782-2704&data=04%7C01%7Clrosenth%40adobe.com%7C243ad27dfc824aa
81afe08d99f978468%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C6377162953833
20501%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik
1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=wbaEtehYy%2Fl5eptlxOsJn0%2F5AgdKgv3nNHOwQF
62AuE%3D&reserved=0>