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

Improve definition of property "encodingFormat" (vs "fileFormat")#1155

Closed
tfrancart opened this issue May 11, 2016 · 7 comments
Closed

Improve definition of property "encodingFormat" (vs "fileFormat") #1155

tfrancart opened this issue May 11, 2016 · 7 comments
Labels
guidelines docs examples Work on our supporting materials rather than on schema definitions schema.org vocab General top level tag for issues on the vocabulary status:work expected We are likely to, or would like to, or probably should try, ... to do something in this area.

Comments

@tfrancart
Copy link
Contributor

Current definition of encodingFormat on schema:MediaObject : "mp3, mpeg4, etc."

Proposal :
"The encoding of the media object. A good practice is to use mime types codes listed at www.iana.org/assignments/media-types/media-types.xhtml, such as "audio/mpeg", "video/ogg", etc."

@vholland
Copy link
Contributor

+1

@danbri danbri added schema.org vocab General top level tag for issues on the vocabulary guidelines docs examples Work on our supporting materials rather than on schema definitions type:easy ones (software/site tools) status:work expected We are likely to, or would like to, or probably should try, ... to do something in this area. labels May 11, 2016
@sballesteros
Copy link

sballesteros commented May 11, 2016

It may be good to clarify the difference with http://schema.org/fileFormat that explicitly asks for the MIME type.

@tfrancart
Copy link
Contributor Author

Seems like encodingFormat is a duplicate of fileFormat ?

@danbri danbri changed the title Improve definition of property "encodingFormat" Improve definition of property "encodingFormat" (vs "fileFormat") Apr 11, 2018
@danbri
Copy link
Contributor

danbri commented Apr 11, 2018

Coming to this late, but yeah - it seems both properties are in use in much the same way. The "fileFormat" property always had a weird name in that HTTP-streamed content is generally not thought of as "files".

I suggest we converge them, by making encodingFormat the preferred term, and indicating fileFormat as supersededBy encodingFormat.

We would need to converge the textual definitions, and also

  • allow encodingFormat on CreativeWork, not just MediaObject
  • allow encodingFormat to take both Text and URL values; we allowed URLs to support scientific file formats on Dataset distributions i.e. DataDownload, when the format is well known and documented but doesn't have an IANA media type, see fileFormat assumes registered mediatypes - need an idiom for obscure formats #1191.
  • we will need some wording to explain possible confusion around the "encoding" property, which relates the vaguer kinds of CreativeWork (like a Book or blog post) to specific digital representations e.g. particular ebook formats.
  • will also need to scan through our examples and update accordingly (see below)

@rvguha - does this make sense to you?

Examples that mention fileFormat

-bash-3.2$ find . -name \*examples.txt -exec grep -Hn fileFormat {} \;
./examples.txt:8857:TYPES: accessibilityFeature, accessibilityHazard, fileFormat
./examples.txt:8869: <meta itemprop="fileFormat" content="image/png">
./examples.txt:8880: <meta property="fileFormat" content="image/png">
./examples.txt:8889:TYPES: fileFormat, accessibilityHazard, accessibilityFeature, accessibilityControl, accessibilityAPI
./examples.txt:8902:   <meta itemprop="fileFormat" content="text/html"/>
./examples.txt:8903:   <meta itemprop="fileFormat" content="image/png"/>
./examples.txt:8904:   <meta itemprop="fileFormat" content="text/css"/>
./examples.txt:8905:   <meta itemprop="fileFormat" content="text/javascript"/>
./examples.txt:8923:   <meta property="fileFormat" content="text/html"/>
./examples.txt:8924:   <meta property="fileFormat" content="image/png"/>
./examples.txt:8925:   <meta property="fileFormat" content="text/css"/>
./examples.txt:8926:   <meta property="fileFormat" content="text/javascript"/>
./examples.txt:8948: "fileFormat" : [

danbri added a commit that referenced this issue Apr 26, 2018
We are converging these two properties. There is nothing wrong
with continuing to use fileFormat, but there is a gentle nudge towards
encodingFormat as the preferred term.
danbri added a commit that referenced this issue Apr 26, 2018
fileFormat to indicate it has been supersededBy encodingFormat.

/cc #1155
danbri added a commit that referenced this issue Apr 26, 2018
Updated definition to give a real example plus MDN link.
/cc #1155
@danbri
Copy link
Contributor

danbri commented Apr 26, 2018

Ok I have implemented this change, queued for review at http://webschemas.org/encodingFormat and http://webschemas.org/fileFormat . The phrasing is still a bit awkward, but we've effectively moved the definitions from fileFormat over to be the new preferred term encodingFormat. I've updated the examples to match, including changing values to be MIME style where needed.

@github-actions
Copy link

This issue is being tagged as Stale due to inactivity.

@github-actions github-actions bot added the no-issue-activity Discuss has gone quiet. Auto-tagging to encourage people to re-engage with the issue (or close it!). label Aug 31, 2020
@danbri
Copy link
Contributor

danbri commented Aug 31, 2020

We did it!

@danbri danbri closed this as completed Aug 31, 2020
@danbri danbri removed the no-issue-activity Discuss has gone quiet. Auto-tagging to encourage people to re-engage with the issue (or close it!). label Aug 31, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
guidelines docs examples Work on our supporting materials rather than on schema definitions schema.org vocab General top level tag for issues on the vocabulary status:work expected We are likely to, or would like to, or probably should try, ... to do something in this area.
Projects
None yet
Development

No branches or pull requests

4 participants