Re: Moving the Realtime Paged Data Specification to Final Specification

Hi all,

Hope you're well!

Just to add to this, below is a list of some of the main revisions made
based on feedback received:

   - The “next” url is now absolute instead of relative.
   - Added clarification around frequency of update and embedded entities.
   - Added SQL examples, and clarity around the SQL query.
   - Clarification of ordering strategies, limiting the spec to either
   modified/id or change number.
   - Formally included the “afterChangeNumber” parameter to clarify the
   difference in ordering strategies.
   - Removal of other transport mechanisms into the beta wiki
   <https://github.com/openactive/realtime-paged-data-exchange/wiki>.
   - Added clarity for consumers of data, and for polling mechanics
   (including last page).
   - Added common implementation issues.
   - Use of a deleted flag is clarified, and deleted items must now
   continue to exist for a period of 48 hours (to allow for nightly
   synchronisation scenarios).
   - Enforced content type of “application/json”.
   - Enforced value formats (e.g. UTC date) and fields in related entities.
   - Added status codes for periods of high load.

Here's a link to the latest version of the spec:
https://www.openactive.io/realtime-paged-data-exchange/

Please do review and post anything you spot as issues on GitHub
<https://github.com/openactive/realtime-paged-data-exchange/issues>.

Many thanks,

Nick

On Fri, Jul 14, 2017 at 4:33 PM, Leigh Dodds <leigh.dodds@theodi.org> wrote:

> Hi,
>
> We've just published a new Editors Draft of the Realtime Paged Data
> Specification (RPDE) [1]. The specification provides a means of publishing
> opportunity data that makes it easy for both publishers and consumers to
> share data.
>
> The previous version of the specification was produced early in the
> OpenActive project and so we've not spent a create deal of time discussing
> it within this group. However Nick Evans has been working closely with
> publishers who are have been implementing the specification as part of
> publishing their data. The specification has been revised and clarified
> based on their feedback.
>
> Currently there are 22 implementations of RPDE which are publishing open
> data as part of OpenActive. 12 of those are publishing data according to
> the Modelling Opportunity Data spec.
>
> We also have some simple reference implementations in Azure [2] and Google
> Apps Script [3]
>
> We think this level of implementation experience means that the
> specification is ready to move forward to Final Specification status
> alongside the data model.
>
> Can I ask that if you'd like to review and provide feedback on the latest
> draft that you do so over the next week? We can then trigger the process to
> move this to Final Specification status at the W3C.
>
> Cheers,
>
> L.
>
> [1]. https://www.openactive.io/realtime-paged-data-exchange/
> [2]. https://github.com/openactive/rpde-sample-azure
> [3]. https://docs.google.com/spreadsheets/d/175BYSYA0aN9KsU62ZFhcaGhwqfrYT
> nJI9dc3ETNCm90/edit#gid=0
>
> --
> Leigh Dodds, Senior Consultant, theODI.org
> @ldodds
> The ODI, 65 Clifton Street, London EC2A 4JE
>
>