deprecate punctuation-dependent markup

1 files changed, 24 insertions, 31 deletions

diff --git a/README.md b/README.md
index b7ad103..ae9fbca 100644
--- a/README.md
+++ b/README.md
@@ -465,37 +465,6 @@ An attribute beginning with the `=` sign indicates a subject IRI, equivalent to
 
 ### Properties in lists
 
-#### Key/Value pairs
-
-If the list item contains `:` or `=`, the annotation is applied to the string after this character.
-If final non-space non-annotation character of the list item is `,` or `;`, the annotation is applied to the string before this character.
-
-```markdown
-- Name: Thomas Francart {foaf:name}
-- Age = 39 {foaf:age}
-- Profession: Semantic Web Consultant; {rdfs:comment}
-- Hobby: Bird watching; train spotting; {rdfs:comment}
-```
-
-Should yield (note how semi-colons are excluded from last annotations):
-
-```html
-<ul>
-  <li>Name: <span property="foaf:name">Thomas Francart</span></li>
-  <li>Age = <span property="foaf:age">39</span></li>
-  <li>Profession: <span property="rdfs:comment">Semantic Web Consultant</span>;</li>
-  <li>Hobby: <span property="rdfs:comment">Bird watching</span>; <span property="rdfs:comment">train spotting</span>;</li>
-</ul>
-```
-
-:::danger
-:heavy_exclamation_mark: FIXME: Undecided if punctuation exceptions for lists should be included
-:::
-
-:::danger
-:heavy_exclamation_mark: FIXME: Undecided if final punctuation should be omitted
-:::
-
 #### Value-only list items
 
 ```markdown
@@ -1135,3 +1104,27 @@ Should yield
   <li>rdfs:comment: <span property="rdfs:comment">Semantic Web Consultant</span></li>
 </ul>
 ```
+
+
+#### Omit list item leading key and trailing repetition punctuation
+
+If the list item contains `:` or `=`, the annotation is applied to the string after this character.
+If final non-space non-annotation character of the list item is `,` or `;`, the annotation is applied to the string before this character.
+
+```markdown
+- Name: Thomas Francart {foaf:name}
+- Age = 39 {foaf:age}
+- Profession: Semantic Web Consultant; {rdfs:comment}
+- Hobby: Bird watching; train spotting; {rdfs:comment}
+```
+
+Should yield (note how semi-colons are excluded from last annotations):
+
+```html
+<ul>
+  <li>Name: <span property="foaf:name">Thomas Francart</span></li>
+  <li>Age = <span property="foaf:age">39</span></li>
+  <li>Profession: <span property="rdfs:comment">Semantic Web Consultant</span>;</li>
+  <li>Hobby: <span property="rdfs:comment">Bird watching</span>; <span property="rdfs:comment">train spotting</span>;</li>
+</ul>
+```