Add Report under Creative Work #374

Open
jkreft-usgs opened this Issue Mar 7, 2015 · 4 comments

Projects

None yet

4 participants

@jkreft-usgs

Reports generated by governmental and non-governmental organizations are currently difficult to describe using schema.org, as they aren't a scholarly article, but don't really fit in anywhere else under CreativeWork either. Report as a type under CreativeWork would give this common publication type an accurate description. Properties for Report could be similar to that of Article, but would also include the report number, a key piece of metadata to describe reports.

  • Report
    • reportBody (Text) The actual body of the report.
    • pagination (Text or Integer) Any description of pages that is not separated into pageStart and pageEnd; for example, "1-6, 9, 55" or "10-12, 46-49".
    • pageStart (Text or Integer) The page on which the work starts; for example "138" or "xvi".
    • pageEnd (Text or Integer) The page on which the work ends; for example "138" or "xvi".
    • wordCount (Integer) The number of words in the text of the Report.
    • reportNumber (Text or Integer) The number or other unique designator assigned to the Report by the publishing organization.

This is an example of a report that I am currently struggling to properly describe with schema.org- a Report CreativeWork type would immediately be put to use here: http://pubs.er.usgs.gov/publication/sir20145235

@Dataliberate
Contributor

Just an observation but would a Report not be just as well served by being a subtype of Article with one new property ‘reportNumber’.

Thing > CreativeWork > Article > Report

~Richard

On 7 Mar 2015, at 00:35, jkreft-usgs <notifications@github.commailto:notifications@github.com> wrote:

Reports generated by governmental and non-governmental organizations are currently difficult to describe using schema.orghttp://schema.org, as they aren't a scholarly article, but don't really fit in anywhere else under CreativeWork either. Report as a type under CreativeWork would give this common publication type an accurate description. Properties for Report could be similar to that of Article, but would also include the report number, a key piece of metadata to describe reports.

  • Report
  • reportBody (Text) The actual body of the report.
  • pagination (Text or Integer) Any description of pages that is not separated into pageStart and pageEnd; for example, "1-6, 9, 55" or "10-12, 46-49".
  • pageStart (Text or Integer) The page on which the work starts; for example "138" or "xvi".
  • pageEnd (Text or Integer) The page on which the work ends; for example "138" or "xvi".
  • wordCount (Integer) The number of words in the text of the Report.
  • reportNumber (Text or Integer) The number or other unique designator assigned to the Report by the publishing organization.

This is an example of a report that I am currently struggling to properly describe with schema.orghttp://schema.org- a Report CreativeWork type would immediately be put to use here: http://pubs.er.usgs.gov/publication/sir20145235


Reply to this email directly or view it on GitHubhttps://github.com/schemaorg/schemaorg/issues/374.

@jkreft-usgs

Putting the report under Article would absolutely be one way to address this issue. It doesn't completely address the highly heterogenous nature of reports (some are really closer to books and have ISBNs and chapters), but it would address a large portion of use-cases

@RichardWallis RichardWallis pushed a commit that referenced this issue Jul 17, 2015
wallisr Added Bridge type - issue #207
Added URL to range of genre - issue #346
Added Report type and reportNumber property - #374
2033985
@RichardWallis RichardWallis added a commit that referenced this issue Jul 17, 2015
@RichardWallis RichardWallis Fixes to Book examples - issue #552
Removed examples that don't reference WebPage from WebPage - issue #382
Added Report / genre example - issue #374
7d414f0
@danbri danbri referenced this issue Jul 21, 2015
Merged

Assorted fixes #648

@danbri
Contributor
danbri commented Jul 21, 2015

We did not have a huge amount of discussion on this, but it is a reasonable idea and so @RichardWallis and I have merged this into the work-in-progress site build to see if it enjoys rough consensus in review.

@fmpalinkas

Hi Dan,

Any chance you can also include "Glossary" with a Term, Definition, and
Reference (URL)?

Kind regards,

Frank M. Palinkas
Senior Technical Writer
Information Architect and Developer
Quixey, Inc., Mountain View, California
Mobile: +1 650 248 5315
Web page: https://github.com/fmpalinkas/web-accessibility-tutorials/wiki

On Tue, Jul 21, 2015 at 7:57 AM, Dan Brickley notifications@github.com
wrote:

We did not have a huge amount of discussion on this, but it is a
reasonable idea and so @RichardWallis https://github.com/RichardWallis
and I have merged this into the work-in-progress site build to see if it
enjoys rough consensus in review.


Reply to this email directly or view it on GitHub
#374 (comment)
.

@danbri danbri removed the type:enhancement label Mar 7, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment