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

Closed
8 tasks
danbri opened this issue May 13, 2015 · 8 comments
Closed
8 tasks

Release snapshot format improvements #484

danbri opened this issue May 13, 2015 · 8 comments
Assignees
Labels
site tools + python code Infrastructural issues around schema.org site. Most can ignore this!
Milestone

Comments

@danbri
Copy link
Contributor

danbri 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 added the site tools + python code Infrastructural issues around schema.org site. Most can ignore this! label May 13, 2015
@danbri danbri self-assigned this May 13, 2015
@danbri danbri added this to the 2015 sometime milestone May 13, 2015
@sopekmir
Copy link
Contributor

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

@Dataliberate
Copy link
Contributor

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

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

danbri commented May 13, 2015

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

@mfhepp
Copy link
Contributor

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

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

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

@danbri
Copy link
Contributor Author

danbri commented Jul 17, 2020

Closing as obsolete

@danbri danbri closed this as completed Jul 17, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
site tools + python code Infrastructural issues around schema.org site. Most can ignore this!
Projects
None yet
Development

No branches or pull requests

5 participants