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

Release snapshot format improvements #484

Open
danbri opened this issue May 13, 2015 · 7 comments

Comments

@danbri
Copy link
Contributor

commented May 13, 2015

Following #441 we have a simple "all in one page" snapshot view of each schema.org version.

This provides most definitions from schema.org versions at stable URLs. Initially:

  • /version/2.0/

At this time the schema encoded in RDFa/RDFS is the canonical representation, and the HTML report is generated programmatically. This meta-issue tracks improvements to the generated HTML release summary page. We may regenerate the snapshot summary from the underlying schema data as this tooling improves, e.g. to provide better formatting and cross-referencing.

Known issues:

  • enums are not represented in human-facing form
  • page navigation is horrible
  • page is gigantic and heavy - should we strip out the definitions, or split them into 1 main line + additional supporting text which might not need to be in the snapshot?
  • other machine formats? JSON-LD, Turtle (TimBL was asking for), N-Quads.
  • should back-port to previous releases.
  • administrivia: document the release process in Wiki.
  • use git tags.
  • /version/x.y/ should link to /docs/releases.html#vx.y

@danbri danbri self-assigned this May 13, 2015

@danbri danbri added this to the 2015 sometime milestone May 13, 2015

@sopekmir

This comment has been minimized.

Copy link
Contributor

commented May 13, 2015

Dan, I get 404 on http://schema.org/version/2.0/
Mirek

@Dataliberate

This comment has been minimized.

Copy link
Contributor

commented May 13, 2015

Take a look at it here http://sdo-gozer.appspot.com/version/2.0/ - its not released yet.

~Richard

On 13 May 2015, at 15:12, sopekmir <notifications@github.commailto:notifications@github.com> wrote:

Dan, I get 404 on http://schema.org/version/2.0/
Mirek


Reply to this email directly or view it on GitHubhttps://github.com//issues/484#issuecomment-101677230.

@danbri

This comment has been minimized.

Copy link
Contributor Author

commented May 13, 2015

Yes, the point is a launch is imminent but there are some various things that need more attention/time. So this bug is linked from those version snapshot pages.

danbri added a commit that referenced this issue May 13, 2015
@danbri

This comment has been minimized.

Copy link
Contributor Author

commented May 13, 2015

@mfhepp

This comment has been minimized.

Copy link
Contributor

commented May 13, 2015

great!


martin hepp
www: http://www.heppnetz.de/
email: mhepp@computer.org

On 13.05.2015, at 23:17, Dan Brickley notifications@github.com wrote:

Ok, we're live. http://schema.org/version/2.0/


Reply to this email directly or view it on GitHub.

@unor

This comment has been minimized.

Copy link
Contributor

commented May 14, 2015

The "advice" link on http://schema.org/version/2.0/ is broken:

http://schema.org/version/2.0/github.com/schemaorg/schemaorg/issues
@danbri

This comment has been minimized.

Copy link
Contributor Author

commented May 14, 2015

Doh, thanks @unor. I've silently fixed this in the live site. I didn't change the archived snapshot in data/releases/2.0/all-schema.html as 1. it isn't served anywhere 2. I think we've set expectations those HTML snapshots will be improved later, only the raw triples are frozen.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
5 participants
You can’t perform that action at this time.