Draft Protocol Spec (Google Wave Federation Protocol) - 1 views
www.waveprotocol.org/...draft-protocol-spec
2010 2010-06 2010-06-12 Google Wave document annotation Extensible Messaging and Presence Protocol
shared by Graham Perrin on 12 Jun 10
- Cached
-
Draft
-
Google Wave Federation Protocol Over XMPP
-
Anthony Baxter, Jochen Bekmann, Daniel Berlin, Soren Lassen, Sam Thorogood
- ...22 more annotations...
-
omits details that we are unable to capture at this point
-
Each document has an id
-
Each wavelet is a container for any number of documents.
-
is composed of an XML document and a set of annotations.
-
Annotations are key-value pairs that span arbitrary ranges of the XML document
-
to represent text formatting, spelling suggestions and hyper-links
-
… and annotations (page comments, highlights, stuck and floating notes) in the Diigo sense?
-
-
independent of the XML document structure
-
A document is a sequence of items
-
Each item has a key-value map of annotations.
-
Annotation keys and values are strings
-
each item conceptually has its own annotation map
-
more efficient to have just one annotation map for each consecutive run of items with the same annotations
-
serialization of the document without annotations into a string is not formally an XML document
-
current annotations update, which is a map of annotation keys to pairs (old-value, new-value), where old-value and new-value are either null or an annotation value
-
After the final component, the annotations update must be empty
-
Document operation components can be divided into four classes
-
do not directly affect the document or the cursor
-
annotation boundaries (annotationBoundary) change the current annotations update
-
interaction with annotations
-
Appendix A. Protocol Schema
-
message AnnotationBoundary { // This field is set to true if and only if both ends and changes are // empty. It is needed to ensure that the optional annotationBoundary // component field is not dropped during serialization. optional bool empty = 1; // MUST NOT have the same string twice. repeated string end = 2; // MUST NOT have two updates with the same key. MUST NOT // contain any of the strings listed in the 'end' field. repeated KeyValueUpdate change = 3; }
-
optional AnnotationBoundary annotationBoundary = 1; optional string characters = 2; optional ElementStart elementStart = 3; optional bool elementEnd = 4; optional int32 retainItemCount = 5; optional string deleteCharacters = 6; optional ElementStart deleteElementStart = 7; optional bool deleteElementEnd = 8; optional ReplaceAttributes replaceAttributes = 9; optional UpdateAttributes updateAttributes = 10;
-
-
Whether 'annotation' in the Google Wave Protocol sense is comparable to annotation in the Diigo sense, I don't know.
-
