Changes between Version 24 and Version 25 of DASISH/Scenario

Timestamp:

04/29/13 15:29:16 (11 years ago)

Author:

olhsha

Comment:

--

DASISH/Scenario

@@ -17 +17 @@
 
 = Authentication =
-* User logs-in to annotation service, so the UID gets known by the server. See [[SpecificationDocument#Userrealm]] and [[XSD and XML#RespondingGETapiuseruid | Getting user information, incl. current-user flag]]
+* User logs-in to annotation service, "uid" gets known by the server. See [[SpecificationDocument#Userrealm]] and [[XSD and XML#RespondingGETapiuseruid | Example: getting user information, incl. current-user flag]]
 
 = Visiting an annotated web page =
@@ -26 +26 @@
 * Service: returns list of annotation URI-s with the corresponding headlines, owners, and target source refs (URI-s);
 
-See [[XSD and XML#RespondingGETapiannotationslinkhttp:en.wikipedia.orgwikiSagrada_FamC3ADliaaccessread | Getting annotations for Sagrada Famiglia wiki-page]]
+See [[XSD and XML#RespondingGETapiannotationslinkhttp:en.wikipedia.orgwikiSagrada_FamC3ADliaaccessread | Example: etting annotations for Sagrada Famiglia wiki-page]]
 
 
-* Client: Resolving fragments (mapping) happens after the response. There are two internal lists for the client: the resolvable and unresolvable target.
+* Client: Resolving fragments (mapping) happens after the response. There are two internal lists for the client: the resolvable and unresolvable targets.
 
 = Viewing an individual annotation =
 
 == Resolvable target ==
-* User: selects an annotation with "at least one resolvable" (debatable) target for reading.  
+* User: selects an annotation with "at least one resolvable" ('''TODO''': at least one? discuss) target for reading.  
 * Client: retrieves the annotation
 * {{{GET api/annotations/<aid>}}}
 * Service: returns the annotation 
 
-See [[XSD and XML#RespondingGETapiannotationsAID02exampleusageforresolvabletargetsources]].
+See [[XSD and XML#RespondingGETapiannotationsAIDzzzexampleofresolvabletargetsources | Example: obtaining an annotation with resolvable target sources].
 
 == Unresolvable target ==
@@ -49 +49 @@
 * {{{GET api/sources/<sid>/cached/<cid>/metadata}}} 
 
-See [[XSD and XML#RespondingGETapiannotationsAID01exampleusageforunresolvabletargetsources]], [[XSD and XML#RespondingGETapiannotationsAID01sourcesexampleusageforunresolvabletargetsources]], [[XSD and XML#RespondingGETapisourcesSID05cachedCID005Ametadataexampleusageforunresolvabletargetsources]].
+See [[XSD and XML#RespondingGETapiannotationsAIDzyyexampleusageforunresolvabletargetsources | Example: getting an annotation with an unresolvable target source]], [[XSD and XML#RespondingGETapiannotationsAIDzyysourcesexampleusageforunresolvabletargetsources | Example: getting target sources for the annotation]], [[XSD and XML#RespondingGETapisourcesSID05cachedCID005Ametadataexampleusageforunresolvabletargetsources | Example: getting a cached representation for the unresolvable target source]].
 
 = Annotation creation =