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

Add Report under Creative Work #374

Open
jkreft-usgs opened this issue Mar 7, 2015 · 5 comments
Open

Add Report under Creative Work #374

jkreft-usgs opened this issue Mar 7, 2015 · 5 comments

Comments

@jkreft-usgs
Copy link

@jkreft-usgs jkreft-usgs commented Mar 7, 2015

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
Copy link
Contributor

@Dataliberate Dataliberate commented Mar 7, 2015

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//issues/374.

@jkreft-usgs
Copy link
Author

@jkreft-usgs jkreft-usgs commented Mar 9, 2015

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 pushed a commit that referenced this issue Jul 17, 2015
Added URL to range of genre - issue #346
Added Report type and reportNumber property - #374
RichardWallis pushed a commit that referenced this issue Jul 17, 2015
Removed examples that don't reference WebPage from WebPage - issue #382
Added Report / genre example - issue #374
@danbri danbri mentioned this issue Jul 21, 2015
@danbri
Copy link
Contributor

@danbri 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.

@ghost
Copy link

@ghost ghost commented Jul 21, 2015

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)
.

@github-actions
Copy link

@github-actions github-actions bot commented Sep 3, 2020

This issue is being tagged as Stale due to inactivity.

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

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.