diff --git a/README.md b/README.md index 36cd1fd..afb61ee 100644 --- a/README.md +++ b/README.md @@ -30,8 +30,10 @@ We use [bikeshed](https://speced.github.io/bikeshed/) with [pipx](https://pipx.p pipx run bikeshed spec spec/.bs ``` -You can also start bikeshed in watch mode to automatically rebuild the spec on changes, and have it serve the spec on a local web server: +You can also start bikeshed in watch mode to automatically rebuild the specs on changes, and have it serve the specs on a local web server: ```bash -pipx run bikeshed serve spec/.bs +pipx run bikeshed serve ``` + +To view, for example, `messages.bs`, open `http://localhost:8000/spec/messages.html` in your web browser. diff --git a/spec/messages.bs b/spec/messages.bs index 50eb549..63620c7 100644 --- a/spec/messages.bs +++ b/spec/messages.bs @@ -15,7 +15,7 @@ Abstract: Concepts and abstract data model for RDF Messages This specification defines the concepts of RDF Messages, RDF Message Streams, and RDF Message Logs, as well as the syntax for serializing RDF Message Logs in various RDF serialization formats. -In this document, we are discussing *message-level* streaming, where streams are sequences of discrete messages, with each message containing multiple RDF quads. This is in contrast to *triple-* or *quad-level* streaming of RDF data, where streams are sequences of individual RDF triples or quads. For quad-level streaming, please refer to, for example: [[!n-quads]], [[!n-triples]], and [[!json-ld11-streaming]]. +In this document, we are discussing *message-level* streaming, where streams are sequences of discrete messages – each message may contain multiple RDF triples or quads. This is in contrast to *triple-* or *quad-level* streaming of RDF data, where streams are sequences of individual RDF triples or quads. For quad-level streaming, please refer to, for example: [[!n-quads]], [[!n-triples]], and [[!json-ld11-streaming]]. Note: Quad-level streaming is complementary to message-level streaming, and both can be used together. This is the case, for example, in the [Jelly](https://w3id.org/jelly/) serialization format, as well as some of the formats proposed in [[#rdf-message-logs-serialization]].