From 39978c89fdd3112108e4f6ebf5dcffb055b5755c Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Mon, 13 Jul 2020 16:19:43 +0200
Subject: fix and improve event list examples

---
 README.md | 35 +++++++++++++++++++++--------------
 1 file changed, 21 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index ae9fbca..b348d1f 100644
--- a/README.md
+++ b/README.md
@@ -755,21 +755,27 @@ Here is our meeting description:
 Annotated version:
 
 ```markdown
-Here is our meeting description: {.schema:Event}
+{.schema:Event}
+
+Here is our meeting description:
 
 - Date: 10/11/2019 {schema:startDate}
 - Location: somewhere {schema:place}
-- Attendees: {schema:attendee}
+- Attendees:
+- {schema:attendee}
   - Alice {schema:name}
     - Engineer {schema:jobTitle}
-    - Works for: Foo {schema:affiliation}
-    - Hobbies: {schema:knowsAbout}
+    - Works for: [Foo]{schema:affiliation}
+    - Hobbies:
+      - {schema:knowsAbout}
       - Football
       - Video games
+- {schema:attendee}
   - Bob {schema:name}
     - Sales Manager {schema:jobTitle}
-    - Works for: Bar {schema:affiliation}
-    - Hobbies: {schema:knowsAbout}
+    - Works for: [Bar]{schema:affiliation}
+    - Hobbies:
+      - {schema:knowsAbout}
       - Cooking
       - Cycling
 ```
@@ -886,8 +892,8 @@ Declare [prefix definitions](#Prefix-definition-syntax), anywhere in the documen
 
 ```markdown
 {.schema:Event}
-* Date: 10/11/2019 {schema:startDate}
-* Location{.ex:good_places}: somewhere {schema:location}
+* Date: [10/11/2019]{schema:startDate}
+* Location: [somewhere]{ex:good_place}
 
 {schema}: http://schema.org/
 
@@ -902,7 +908,7 @@ Should yield
 <div prefix="ex: http://example.org/">
     <ul typeof="Event">
         <li>Date: <span property="startDate">10/11/2019</span></li>
-        <li><span property="ex:good_places">Location</span>: <span property="location">somewhere</span></li>
+        <li>Location: <span property="ex:good_place">somewhere</span></li>
     </ul>
 </div>
 ```
@@ -913,10 +919,6 @@ Notice how prefixes "schema" and "rdfs" are omitted, because they are implicitly
 :heavy_exclamation_mark: FIXME: Undecided if prefix declared in the source should always be converted in the output or omitted if unneeded as per Core Initial Context or when unused.
 :::
 
-:::danger
-:heavy_exclamation_mark: FIXME: The example is inconsistent as it defines 2 properties in the second li : `<li><span property="ex:good_places">Location</span>: <span property="location">somewhere</span></li>`
-:::
-
 ### Prefix and link definitions have similar but separate syntax
 
 Prefixes mimic the syntax for links, but using curly brackets instead of angle brackets:
@@ -1003,7 +1005,8 @@ Meeting with [Bob]{.f:Person}
 ## Parallel Idea: Indented Lists using Link References (JSON-LD or YAML-like lists).
 
 ```markdown
-## {.schema:Event} Bird watchers meeting
+## {.schema:Event}
+## Bird watchers meeting
 
 - [Date]: 10/11/2019
 - [Location]: somewhere
@@ -1021,6 +1024,10 @@ Meeting with [Bob]{.f:Person}
       - Cooking
       - Cycling
 
+## Train spotters meeting
+
+(TODO)
+
 [Date]: {schema:startDate}
 [Location]: {schema:Location}
 [Name]: {schema:name}
-- 
cgit v1.2.3