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

Jump to bottom

Meta-issue for sdo-deimos release (eventually named as version 3.0) #911

Closed
14 of 18 tasks
danbri opened this issue Nov 30, 2015 · 44 comments
Closed
14 of 18 tasks

Meta-issue for sdo-deimos release (eventually named as version 3.0) #911

danbri opened this issue Nov 30, 2015 · 44 comments
Milestone
sdo-deimos release

Comments

@danbri
Copy link
Contributor

danbri commented Nov 30, 2015 •
edited

This issue tracks release planning for schema.org's release codenamed sdo-deimos. It is likely to be released as v2.3 in late 2015 or early 2016. It was released as v3.0 in May 2016.

Early Access fixes

The following changes are proposed for immediate "early access" publication on the schema.org site. Such changes will be considered part of the eventual following release, for versioning/snapshot purposes. They will be published as soon as they get OK'd by the schema.org steering group.

 Fix for 500 error codes - #899 - in #901

SG signoffs:

  • Shankar/Tom/Steve
  • Charles/Alex
  • Peter
  • Martin
  • Stéphane
  • Vicki/Dan

 Fix for needless complex JSON-LD periodicals example - #904 in dbs@8ecbfe0

  • Shankar/Tom/Steve
  • Charles/Alex
  • Peter
  • Martin
  • Stéphane
  • Vicki/Dan

Main content of release

(discussion invited, here or in email )

(checkmarks indicate a rough consensus design is implemented for final review)

Proposals for this release include:
@danbri danbri mentioned this issue Nov 30, 2015
Open
24 tasks
@philbarker
Copy link
Contributor

The examples for LRMI are ready, we'ld love to see them in the next release (see pull request #902 , sorry no issue raised)

@danbri
Copy link
Contributor Author

danbri commented Dec 1, 2015

LRMI examples would be great - let's do that

@vholland
Copy link
Contributor

vholland commented Dec 3, 2015

Would it be possible to also add the following:

@mfhepp
Copy link
Contributor

mfhepp commented Dec 3, 2015

I just added the hotel extension proposal #915 / #916. That would be a priority for me for the next release. Also, we should aim to finalize auto.schema.org (a pull-request is coming in the next days).

@RichardWallis
Copy link
Contributor

Added moving the current auto & bib extensions from pre-final preview release to a released state.

@rtroncy rtroncy mentioned this issue Dec 5, 2015
Closed
@danbri
Copy link
Contributor Author

danbri commented Dec 7, 2015

(@mfhepp notes in IM chat that he has also checked off the 'early access fixes' above, which means we're good to go there)

@danbri danbri mentioned this issue Feb 16, 2016
Closed
@danbri
Copy link
Contributor Author

danbri commented Feb 26, 2016

OK it's time we started pulling this together as a release. Questions...

How ready are we with hotels? How close to some kind of consensus around dayOfWeek and opening hour improvements? What status updates for the bib.schema.org and auto.schema.org hosted extensions would be appropriate, and where/how shall we link the recently published GS1 external extension?

As a release http://sdo-deimos.appspot.com/docs/releases.html is quite slim. We should also collect up a few "low hanging fruit" bugfixes and simple improvements if there are any obvious quick-fix candidates.

/cc @scor @mfhepp @vholland @chaals @pmika @shankarnat @rvguha

@danbri
Copy link
Contributor Author

danbri commented Feb 26, 2016

Extensions

@Dataliberate
Copy link
Contributor

Scanning through the current set of PRs I believe the following are also good candidates for this release:

@unor
Copy link
Contributor

unor commented Feb 26, 2016

I think two of my old PRs might be candidates for "quick fixes and easy wins", as they only fix example markup and got reviews:

I guess #909 ("Review example: use reviewBody instead of description") should be uncontroversial, too (would fix/close #881), but got no reviews.

@danbri
Copy link
Contributor Author

danbri commented Feb 26, 2016

Thanks @unor - those look useful, sorry we didn't get to them sooner!

@vholland
Copy link
Contributor

Skimming through, I have a couple of (seemingly) uncontroversial pull requests that I would like to get in.

@unor
Copy link
Contributor

unor commented Feb 26, 2016

Some more easy/uncontroversial PRs:

@wikier
Copy link
Contributor

wikier commented Feb 29, 2016

I wonder when could be the right time to properly discuss the event series and related features:

@danbri
Copy link
Contributor Author

danbri commented Feb 29, 2016

Event series may also be interesting wrt the Courses discussion nearby, where there is a need to distinguish the "course in the abstract" from a particular occurrence of it. The model feels a little different in that "lecture 5" in a sequence could occur eg 3 times in one year, but it is related somehow.

@philbarker
Copy link
Contributor

+1 for Event Series as useful for Courses. 'Educational course is defined as "some sequence of events and/or creative works which aims to build the knowledge, competence or ability of learners".'

@danbri
Copy link
Contributor Author

danbri commented Feb 29, 2016

http://schema.org/workFeatured could help bridge educational events to
associated documentation eg curriculum / schedules

On Mon, 29 Feb 2016, 11:17 Phil Barker notifications@github.com wrote:

+1 for Event Series as useful for Courses. 'Educational course is defined
as "some sequence of events and/or creative works which aims to build the
knowledge, competence or ability of learners".'

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

@wikier
Copy link
Contributor

wikier commented Feb 29, 2016

Ok @danbri, so since we didn't make it for sdo-gozer (v2.0), what aspects we should work out to get support for event series shipped into sdo-deimos (v2.3)?

@danbri
Copy link
Contributor Author

danbri commented Mar 7, 2016

@wikier re event series, could you take a look at the Courses discussions? They are currently struggling with the problem of describing a course in the abstract versus a course as a specific sequence of actual events. @philbarker probably has the best pointers but see the mailing list for one entry point.

@danbri
Copy link
Contributor Author

danbri commented Mar 7, 2016

I am working through the lists above. I would also like to fix #143 finally.

@danbri
Copy link
Contributor Author

danbri commented Mar 18, 2016

I've just #880 - added http://sdo-deimos.appspot.com/disambiguatingDescription - I think the Wikipedia usecase is compelling, but review welcomed.

@danbri
Copy link
Contributor Author

danbri commented Apr 11, 2016 •
edited

http://webschemas.org/docs/releases.html is up to date with all changes in sdo-deimos repo.

Summarizing issues suggested in this thread...

# Fixed / merged / done

For pending.schema.org on-ramp

Still in progress

@danbri
Copy link
Contributor Author

danbri commented Apr 11, 2016

I have also just merged two piece of infrastructural work from @RichardWallis

Thanks @RichardWallis :) (he's now taking a look at #990)

@danbri
Copy link
Contributor Author

danbri commented Apr 19, 2016

http://webschemas.org/docs/releases.html is now up to date with the repository so far. There are still some todos. Expecting FIBO and Hotels related pull requests from @RichardWallis and @mfhepp imminently. I am still doing QA on the gigantic medical changes, and I want to see what incremental progress we can mine from the various opening hours discussions. But do please take a look, we're nearly there...

@Dataliberate
Copy link
Contributor

Dataliberate commented Apr 19, 2016 •
edited by danbri

Issue #1059 #1059: Created
hosted extensions for ‘meta' vocabulary and for 'proposed' vocabulary under
review.

Shouldn’t that read ‘pending’ vocabulary under review.
——-

[core] Various typo fixes (including #1014
#1014. - missing closing
bracket.

@danbri
Copy link
Contributor Author

danbri commented Apr 20, 2016

re #143 I saw @chaals yesterday and we agreed that switching from 'time' to 'span' made sense for non-standardized openingHours property values; that has been implemented.

@danbri
Copy link
Contributor Author

danbri commented Apr 20, 2016

Days of week / opening hours fixes are in. I'll circulate this for review as a release candidate.

@danbri
Copy link
Contributor Author

danbri commented Apr 20, 2016

Release candidate is for review. Thanks everyone for getting us this far :)

https://lists.w3.org/Archives/Public/public-schemaorg/2016Apr/0053.html

@danbri danbri added this to the sdo-deimos release milestone Apr 20, 2016
@danbri
Copy link
Contributor Author

danbri commented Apr 21, 2016

@trypuz notes that "There is some error „404 Not Found” on http://webschemas.org/version/3.0/". This is true - the process for generating a full release is quite involved (see details at https://github.com/schemaorg/schemaorg/blob/sdo-deimos/RELEASING.TXT) so normally this happens only at final publication. I should make that more clear in the candidate release version of releases.html - thanks!

@danbri danbri mentioned this issue Apr 21, 2016
Open
@chaals
Copy link
Contributor

chaals commented Apr 27, 2016

+1 for shipping.

@danbri
Copy link
Contributor Author

danbri commented Apr 28, 2016

Update w.r.t. releasing: we have +1s on shipping from @chaals @shankarnat @pmika @rvguha @danbri, waiting for @mfhepp and @scor (who thinks we may have some bugs left around opening hours).

@betehess
Copy link
Contributor

betehess commented Apr 28, 2016 •
edited

As commented in #923 (comment), I think that PublicHolidays should not go in this release.

If the steering committee wants to go ahead, that's fine, I do not want my comment to be a blocker.

@danbri
Copy link
Contributor Author

danbri commented Apr 28, 2016

Perhaps you meant to write "do not", @betehess?

@betehess
Copy link
Contributor

@danbri yes, I realized my mistake right after clicking the "Comment" button. I actually wanted to emphasize the "do not" to make it clear, but my brain had a hiccup :-) I had already updated my comment in the GitHub UI.

I do think more thinking should go into PublicHolidays.

@danbri
Copy link
Contributor Author

danbri commented Apr 28, 2016

Re PublicHolidays I've filed #1139 but I'm coming at this from the view that we have already effectively had PublicHolidays for ~4 years. If we're going to add http://schema.org/Monday etc now we ought to provide a migration path for people using all the previous longer URLs for DayOfWeek.

What I'd suggest (for after this release) is that it would be good to have some collaboration on a simple unit testing structure for openingHours information, to encourage interoperable implementation.

e.g. input to the test could be...

  • a set of triples representing information parsed from Microdata, JSON-LD or RDFa structured data
  • a date/time in some ISO 8601 subset
  • other contextual information e.g. a list of dates of public holidays for the appropriate locale

The output would be a boolean, whether the date/time is considered 'open' vs 'closed'.

@betehess
Copy link
Contributor

I had not realized it was already there! I agree with the rationale of keeping it.

Let's discuss about what to do with it in the next release.

@mfhepp
Copy link
Contributor

mfhepp commented Apr 29, 2016

Related resources (not necessarily up to date ;-):

Martin

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

On 28 Apr 2016, at 21:44, Dan Brickley notifications@github.com wrote:

Re PublicHolidays I've filed #1139 but I'm coming at this from the view that we have already effectively had PublicHolidays for ~4 years. If we're going to add http://schema.org/Monday etc now we ought to provide a migration path for people using all the previous longer URLs for DayOfWeek.

What I'd suggest (for after this release) is that it would be good to have some collaboration on a simple unit testing structure for openingHours information, to encourage interoperable implementation.

e.g. input to the test could be...

• a set of triples representing information parsed from Microdata, JSON-LD or RDFa structured data
• a date/time in some ISO 8601 subset
• other contextual information e.g. a list of dates of public holidays for the appropriate locale
The output would be a boolean, whether the date/time is considered 'open' vs 'closed'.

—
You are receiving this because you were mentioned.
Reply to this email directly or view it on GitHub

@danbri
Copy link
Contributor Author

danbri commented Apr 30, 2016

Ok via #1139 I think we're ok now with PublicHolidays for the release.

@danbri
Copy link
Contributor Author

danbri commented May 4, 2016

Ok release time. I'm about to work through the (rough) notes in https://github.com/schemaorg/schemaorg/blob/sdo-deimos/RELEASING.TXT ... essentially creating the derived per-release files that we snapshot. The DNS entries for new subdomains (pending.schema.org, health-lifesci.schema.org) should be mostly propagated already.

danbri added a commit that referenced this issue May 4, 2016
@danbri
Updated release notes for v3.0.
0d9e497 
See #911
danbri added a commit that referenced this issue May 4, 2016
@danbri
Added releaselog entry for version 3.0.
72a41fa 
See #911
danbri added a commit that referenced this issue May 4, 2016
@danbri
Fixed within-page references.
279cc71 
Link to #propaz works, and links to each property work.
Note that each per-property section may mention others and those
links sometimes fail. Markdown is pre-processed though.

For v3.0 release.
See #911.
danbri added a commit that referenced this issue May 4, 2016
@danbri
All of core in one page, for release snapshot.
21513bc 
See #911.
@danbri danbri mentioned this issue May 4, 2016
Merged
@danbri
Copy link
Contributor Author

danbri commented May 4, 2016 •
edited

# v3.0 releasing

  • releases.html updated with dated links and release description.
  • scripts/run_tests.py no surprises.
  • docs/qa.html all links healthy.
  • any new DNS changes for extension subdomains have had 24h+ to propagate.
  • sdoapp.py updated with matching SCHEMA_VERSION and releaselog entries.
  • releases filetree static snapshot data:
    • mkdir data/releases/3.0/
    • cp data/schema.rdfa data/releases/3.0/
    • generate nquads/ntriples/turtle for core and for each extension, with #v3.0 in graph URI for the quads.
    • generate concatenated file from quads
  • snapshot the per-release HTML summary page.
    • make sure all new files added to git repository.

@danbri danbri mentioned this issue May 4, 2016
Merged
@danbri
Copy link
Contributor Author

danbri commented May 4, 2016

Ok this is mostly published but we have an issue with AppEngine: the new subdomains for pending, meta and health-lifesci are not routing correctly to the appengine app.

I will leave the new version published, despite this. It will mean a few people find links that don't yet work. I hope to get this fixed asap.

@danbri
Copy link
Contributor Author

danbri commented May 4, 2016

I've set things in motion for the subdomain URL mapping issue to be fixed (short version: we're using a special version of AppEngine with hidden complexities). This could take anything from 24h until early next week, so I have for now rolled back the site to the state of things on 2015-11-05. Apologies for the gracelessness! /cc @RichardWallis

@danbri
Copy link
Contributor Author

danbri commented May 11, 2016

Subdomain issue is fixed and the site is (largely) published, however there is also a problem with caching of old content - sometimes it is serving v2.2 version of pages (at least homepage and docs/schema.html). I have initiated a cache flush which might take 48h. Apologies for the clumsy release engineering...

See also https://lists.w3.org/Archives/Public/public-schemaorg/2016May/0042.html

@danbri danbri changed the title Meta-issue for sdo-deimos release (likely as version 2.3) Meta-issue for sdo-deimos release (eventually named as version 3.0) Jun 17, 2016
@danbri
Copy link
Contributor Author

danbri commented Jul 31, 2016

Closing. #1212 is proposed for release as version 3.1, and should address the various glitches from 3.0.

@danbri danbri closed this as completed Jul 31, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
sdo-deimos release
Development

No branches or pull requests
10 participants
@danbri @betehess @philbarker @mfhepp @wikier @vholland @chaals @unor @Dataliberate @RichardWallis