Describe Notepad

Author: michielbdejong

Documentation/conventions.md

@@ -4,13 +4,16 @@
 * @prefix acl: <http://www.w3.org/ns/auth/acl#>.
 * @prefix dc: <http://purl.org/dc/elements/1.1/>.
 * @prefix dct: <http://purl.org/dc/terms/>.
+* @prefix flow: <http://www.w3.org/2005/01/wf/flow#>.
 * @prefix foaf: <http://xmlns.com/foaf/0.1/>.
+* @prefix ical: <http://www.w3.org/2002/12/cal/ical#>. 
 * @prefix ldp: <http://www.w3.org/ns/ldp#>.
 * @prefix mee: <http://www.w3.org/ns/pim/meeting#>.
 * @prefix pim: <http://www.w3.org/ns/pim/space#>.
 * @prefix schema: <http://schema.org/>.
 * @prefix sioc: <http://rdfs.org/sioc/ns#>.
 * @prefix solid: <http://www.w3.org/ns/solid/terms#>.
+* @prefix ui: <http://www.w3.org/ns/ui#>.
 * @prefix vcard: <http://www.w3.org/2006/vcard/ns#>.
 * @prefix xsd: <http://www.w3.org/2001/XMLSchema#>.
 
@@ -74,4 +77,54 @@ To add a message in the chat conversation, for instance where you say "hi", gene
 * </chat.ttl#Msg1555487418787> sioc:content "hi"
 * </chat.ttl#Msg1555487418787> foaf:maker </profile/card#me>
 
-Note that for historical reasons, for the chat conversation as a whole, we use `dc:created` and `dc:author`, whereas for the individual chat messages we use `dct:created` and `foaf:maker`.
+Note that for historical reasons, for the chat conversation as a whole, we use `dc:created` and `dc:author`, whereas for the individual chat messages we use `dct:created` and `foaf:maker`.
+
+# Notepad
+To create a new notepad at /notepad.ttl, add the following triples into it:
+* </notepad.ttl#this> a pim:Notepad
+* </notepad.ttl#this> dc:author </profile/card#me>
+* </notepad.ttl#this> dc:created "2019-04-17T08:05:19Z"^^XML:dateTime
+* </notepad.ttl#this> dc:title "Shared Notes"
+
+Now to indicate that his notepad is empty, add an empty first line to it:
+* </notepad.ttl#this> pim:next </notepad.ttl#this_line0>
+* </notepad.ttl#line0> dc:author </profile/card#me>
+* </notepad.ttl#line0> dc:content ""
+
+Now indicate that this is the last line, set this line's pim:next to the notepad itself:
+* </notepad.ttl#line0> pim:next </notepad.ttl#this>
+
+To add a line to the notepad, for instance 'first line', first update the content of the first line, by replacing
+* </notepad.ttl#line0> dc:content ""
+with
+* </notepad.ttl#line0> dc:content "first line"
+and then add a new participation-line below it, where the user can type their next line; pick a timestamp, for instance 1555488949899, and add the following triples:
+* </notepad.ttl#this> flow:participation </notepad.ttl#id1555488949899>
+* </notepad.ttl#id1555488949899> flow:participant </profile/card#me>
+* </notepad.ttl#id1555488949899> ical:dtstart "2019-04-17T08:05:22Z"^^XML:dateTime
+* </notepad.ttl#id1555488949899> ui:backgroundColor "#c0d2fe"
+
+Note that the first line still is the only line in the document, apart from the participation line. To add a second line, start making proper use of the pim:next attribute, by linking the first line to the second line, and then linking the second line back up to the notepad as a whole. The participation line stays as it is. The result will then look like this:
+
+### Main notepad
+* </notepad.ttl#this> a pim:Notepad
+* </notepad.ttl#this> dc:author </profile/card#me>
+* </notepad.ttl#this> dc:created "2019-04-17T08:05:19Z"^^XML:dateTime
+* </notepad.ttl#this> dc:title "Shared Notes"
+* </notepad.ttl#this> pim:next </notepad.ttl#this_line0>
+* </notepad.ttl#this> flow:participation :id1555488949899
+
+### Participation
+* </notepad.ttl#id1555488949899> flow:participant </profile/card#me>
+* </notepad.ttl#id1555488949899> ical:dtstart "2019-04-17T08:05:22Z"^^XML:dateTime
+* </notepad.ttl#id1555488949899> ui:backgroundColor "#c0d2fe"
+
+### First line
+* </notepad.ttl#line0> dc:author </profile/card#me>
+* </notepad.ttl#line0> dc:content "first line"
+* </notepad.ttl#line0> pim:next :id1555489499814 
+
+### Second line
+* </notepad.ttl#id1555489499814> dc:author </profile/card#me>
+* </notepad.ttl#id1555489499814> dc:content "second line"
+* </notepad.ttl#id1555489499814> pim:next :</notepad.ttl#this>