Document Meeting tool

Author: michielbdejong

Documentation/conventions.md

@@ -16,6 +16,7 @@ For short-hand, we will use the following namespace prefixes here:
 * @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 rdf: http://www.w3.org/2000/01/rdf-schema#>.
 * @prefix schema: <http://schema.org/>.
 * @prefix sioc: <http://rdfs.org/sioc/ns#>.
 * @prefix solid: <http://www.w3.org/ns/solid/terms#>.
@@ -30,40 +31,47 @@ One of the most important RDF documents on your pod is your profile, which is th
 ## Profile
 ### Profile document
 To add information to your webid profile, you can use the following triples. Suppose your webid is /profile/card#me, then your profile document is /profile/card (without the '#me'). Add the following triples to it:
+
 * </profile/card> a foaf:PersonalProfileDocument
 * </profile/card> foaf:maker </profile/card#me>
 * </profile/card> foaf:primaryTopic </profile/card#me>
 
 ### You as a person
 Now say your name is "John Doe", then add these triples to your profile document to publish your identity as a person:
+
 * </profile/card#me> a foaf:Person
 * </profile/card#me> a schema:Person
 * </profile/card#me> foaf:name "John Doe"
 
 ### Linking to your pod
 Say your pod is at /pod, with the LDN inbox at /pod/inbox/, to link from your identity to your pod:
+
 * </profile/card#me> solid:account </pod>
 * </profile/card#me> pim:storage </pod>
 * </profile/card#me> ldp:inbox </pod/inbox/>
 
 ### Preferences
 To publish some of your generic preferences to apps, use:
+
 * </profile/card#me> pim:preferencesFile </settings/prefs.ttl>
 * </profile/card#me> solid:publicTypeIndex </settings/publicTypeIndex.ttl>
 * </profile/card#me> solid:privateTypeIndex </settings/privateTypeIndex.ttl>
 
 ## Addressbook
 You can create an addressbook containing persons and groups, by adding triples to RDF documents on your pod.
 To create an addressbook, create a document for it, e.g. /address-book/index.ttl, and add the following triples to that document:
+
 * </address-book/index.ttl#this> a vcard:AddressBook
 * </address-book/index.ttl#this> dc:title "New address Book"
 * </address-book/index.ttl#this> acl:owner </profile/card#me>
 
 You can create separate documents for the people index and for the groups index, as long as you link to those from the main /address-book/index.ttl document in the following ways:
+
 * </address-book/index.ttl#this> vcard:nameEmailIndex </address-book/peopleIndex.ttl>
 * </address-book/index.ttl#this> vcard:groupIndex </address-book/groupIndex.ttl>
 
 To indicate that a person /johnDoe.ttl with full name "John Doe" is in addressbook /address-book/index.ttl, add the following triples:
+
 * </johnDoe.ttl#this> vcard:inAddressBook /address-book/index.ttl#this (NB: needs to be in /address-book/peopleIndex.ttl)
 * </johnDoe.ttl#this> a vcard:Individual
 * </johnDoe.ttl#this> vcard:fn "John Doe"
@@ -76,24 +84,32 @@ To indicate that addressbook /address-book/index.ttl has a group called "Colleag
 
 ## 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
@@ -126,12 +142,14 @@ Note that the first line still is the only line in the document, apart from the
 
 ## Chat
 To create a chat conversation, create a document, e.g. /chat.ttl, and add the following triples to it:
+
 * </chat.ttl#this> a mee:LongChat
 * </chat.ttl#this> dc:author </profile/card#me>
 * </chat.ttl#this> dc:created "2018-07-06T21:36:04Z"^^XML:dateTime
 * </chat.ttl#this> dc:title "Chat channel"
 
 To add a message in the chat conversation, for instance where you say "hi", generate a timestamp like 1555487418787 and add the following triples to /chat.ttl:
+
 * </chat.ttl#Msg1555487418787> dct:created "2019-04-17T07:50:18Z"^^XML:dateTime
 * </chat.ttl#Msg1555487418787> sioc:content "hi"
 * </chat.ttl#Msg1555487418787> foaf:maker </profile/card#me>
@@ -142,6 +160,7 @@ Note that for historical reasons, for the chat conversation as a whole, we use `
 LongChat is similar to Chat, except that it uses LDP containers to discover the triples that describe the chat conversation,
 instead of having all the triples in one chat.ttl doc.
 To create a chat conversation, pick a timestamp, e.g. 1555491215455, create an LDP container, for instance /long-chat/, and in there, create an index document, e.g. /long-chat/index.ttl. To the index document, add the following triples:
+
 * </long-chat/index.ttl#this> a mee:LongChat
 * </long-chat/index.ttl#this> dc:author </profile/card#me>
 * </long-chat/index.ttl#this> dc:created "2018-07-06T21:36:04Z"^^XML:dateTime
@@ -153,6 +172,7 @@ To create a chat conversation, pick a timestamp, e.g. 1555491215455, create an L
 * </long-chat/index.ttl#id1555491215455> ui:backgroundColor "#c0d2fe"
 
 To add a message in the LongChat conversation, for instance where you say "hi", pick a filename, for instance /long-chat/2019/04/17/chat.ttl, generate a timestamp like 1555487418787 and add the following triples to /long-chat/2019/04/17/chat.ttl:
+
 * </long-chat/2019/04/17/chat.ttl#Msg1555487418787> dct:created "2019-04-17T07:50:18Z"^^XML:dateTime
 * </long-chat/2019/04/17/chat.ttl#Msg1555487418787> sioc:content "hi"
 * </long-chat/2019/04/17/chat.ttl#Msg1555487418787> foaf:maker </profile/card#me>
@@ -162,7 +182,34 @@ Note that there is no need to make /long-chat/2019/04/17/chat.ttl discoverable f
 Also note that here too, 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`.
 
 ## Meeting
-// TODO
+To create a meeting, create a document, e.g. /meeting.ttl and add the following triples to it:
+
+* </meeting.ttl#this> a mee:Meeting
+* </meeting.ttl#this> dc:author </profile/card#me>
+* </meeting.ttl#this> dc:created "2018-07-06T21:36:04Z"^^XML:dateTime
+* </meeting.ttl#this> flow:participation :id1555491215455
+* </meeting.ttl#this> ui:backgroundColor "#ddddcc"^^XML:color
+* </meeting.ttl#this> mee:toolList ( </meeting.ttl#this> )
+* </meeting.ttl#id1555491215455> ic:dtstart "2019-04-17T08:53:35Z"^^XML:dateTime
+* </meeting.ttl#id1555491215455> flow:participant </profile/card#me>
+* </meeting.ttl#id1555491215455> ui:backgroundColor "#c0d2fe"
+
+To add some details, pick a name like "Weekly Meeting"(note the use of `ical:summary` instead of `dc:title` here), a start and end date/time, a comment like "Discuss weekly things", and a location like "Utrecht", and add them using the ical namespace:
+
+* </meeting.ttl#this> ical:summary "Weekly Meeting"
+* </meeting.ttl#this> ical:comment "Discuss weekly things";
+* </meeting.ttl#this> ical:dtstart "2019-04-19"^^XML:date;
+* </meeting.ttl#this> ical:dtend "2019-04-20"^^XML:date;
+* </meeting.ttl#this> ical:location "Utrecht";
+
+To add material to the meeting (let's say https://example.com/agenda-meeting.html), pick a timestamp like 1555492506279, remove the old `mee:toolList` triple which only contained `</meeting.ttl#this>`, and add the following triples:
+
+* </meeting.ttl#this> mee:toolList ( </meeting.ttl#this> </meeting.ttl#id1555492030413> ) # updated from earlier
+* </meeting.ttl#id1555492506279> a mee:Tool
+* </meeting.ttl#this> flow:attachment <https://example.com/agenda-meeting.html>
+* </meeting.ttl#id1555492506279> mee:target <https://example.com/agenda-meeting.html>
+* </meeting.ttl#id1555492506279> rdf:label "Agenda"
+* </meeting.ttl#id1555492506279> mee:view "iframe"
 
 ## Event
 // TODO