From afe487db43fffedf627331475d36af87a1bb67c6 Mon Sep 17 00:00:00 2001
From: Thomas <31560900+0xtlt@users.noreply.github.com>
Date: Thu, 5 Jan 2023 20:17:12 +0100
Subject: [PATCH 1/4] Create 41.md

---
 41.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 41.md

diff --git a/41.md b/41.md
new file mode 100644
index 0000000000..d6e60dd3a9
--- /dev/null
+++ b/41.md
@@ -0,0 +1,46 @@
+NIP-41
+======
+
+### Poll & Vote Event
+-----------------------------------
+
+`draft` `optional` `author:0xtlt`
+
+An event with kind `1` that wants to contain a poll can do so by adding poll tags and its content as follows:
+
+```json
+{
+  ...
+  "kind": 1,
+  "tags": [
+    ...
+    ["poll", "Choice 1"],
+    ["poll", "Choice 2"],
+    ["poll", "Choice 3"]
+    ...
+  ],
+}
+```
+
+Then the client should display voting options if more than **1 choice** is present in the poll.
+
+The client can then submit the vote by sending an event with kind `8` and its content which will be the index (start at `0`) of the chosen choice.
+
+It should also contain an `e` tag with the id of the poll event only.
+
+```json
+{
+  ...
+  "kind": 8,
+  "tags": [
+    ...
+    ["e", "<event-id>"]
+    ...
+  ],
+  "content": "1"
+}
+```
+
+#### Warning
+
+Keep in mind that all votes are public and accessible to everyone.

From 4b475728568b2b1f0388a77179f8b25187e0f477 Mon Sep 17 00:00:00 2001
From: Thomas <31560900+0xtlt@users.noreply.github.com>
Date: Tue, 28 Feb 2023 09:35:24 +0100
Subject: [PATCH 2/4] :up: Poll update

---
 41.md | 56 ++++++++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 42 insertions(+), 14 deletions(-)

diff --git a/41.md b/41.md
index d6e60dd3a9..458ddd5b36 100644
--- a/41.md
+++ b/41.md
@@ -1,12 +1,27 @@
-NIP-41
-======
-
-### Poll & Vote Event
------------------------------------
+# NIP-41 - Poll & Vote Event
 
 `draft` `optional` `author:0xtlt`
 
-An event with kind `1` that wants to contain a poll can do so by adding poll tags and its content as follows:
+> Poll and vote events are a way to create a poll and vote for it.\
+> Polls are directly integrated into message events (1), and responses are vote events (9) to avoid overloading the loading of messages in clients.
+
+## Specs
+
+### Kind `1` - Message & Poll
+
+To create a poll, include a `poll` tag in the message event. with the following format:
+
+```json
+tag: poll
+options:
+ - <multi|single> allow others to reply with one or multiple options
+ - <ttl> TTL (in seconds|timestamp) when surv expires, 0 TTL don't expire
+ - [<option>]: array of string
+```
+
+And you can also add a `poll_name` tag to add a title to the poll, but it's optional.
+
+#### Example - Message
 
 ```json
 {
@@ -14,24 +29,29 @@ An event with kind `1` that wants to contain a poll can do so by adding poll tag
   "kind": 1,
   "tags": [
     ...
-    ["poll", "Choice 1"],
-    ["poll", "Choice 2"],
-    ["poll", "Choice 3"]
+    ["poll", "Option 1", "Option 2", "Option 3"],
+    ["poll_name", "This is optional"]
     ...
   ],
 }
 ```
 
-Then the client should display voting options if more than **1 choice** is present in the poll.
+### Kind `9` - Vote
 
-The client can then submit the vote by sending an event with kind `8` and its content which will be the index (start at `0`) of the chosen choice.
+To vote for a poll, you have to send an event kind `9`.\
+The format of the event is the following:
 
-It should also contain an `e` tag with the id of the poll event only.
+```json
+kind: 9
+content: <choice, which is the index of the option | the first option is 0>
+```
+
+#### Example - Vote
 
 ```json
 {
   ...
-  "kind": 8,
+  "kind": 9,
   "tags": [
     ...
     ["e", "<event-id>"]
@@ -41,6 +61,14 @@ It should also contain an `e` tag with the id of the poll event only.
 }
 ```
 
-#### Warning
+## Relay and client recommendations
+
+- Options should be limited to 4 options and should not display more than **4 options** in the poll
+- Each option should be 25 chars limited
+- Clients should display poll options if more than **one option** is present in the poll
+- Clients should ignore vote events if the poll is **expired**
+- Clients should not display more than one poll per message. The first poll in the message should be displayed.
+
+## Warning
 
 Keep in mind that all votes are public and accessible to everyone.

From 00dc874f59569250f0dfd404f1e32c0b79366aaf Mon Sep 17 00:00:00 2001
From: Thomas <31560900+0xtlt@users.noreply.github.com>
Date: Tue, 28 Feb 2023 09:41:01 +0100
Subject: [PATCH 3/4] :up: Poll Update

---
 41.md | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/41.md b/41.md
index 458ddd5b36..90859d95c2 100644
--- a/41.md
+++ b/41.md
@@ -16,11 +16,10 @@ tag: poll
 options:
  - <multi|single> allow others to reply with one or multiple options
  - <ttl> TTL (in seconds|timestamp) when surv expires, 0 TTL don't expire
+ - <title> optional poll name ("" if not present)
  - [<option>]: array of string
 ```
 
-And you can also add a `poll_name` tag to add a title to the poll, but it's optional.
-
 #### Example - Message
 
 ```json
@@ -29,8 +28,7 @@ And you can also add a `poll_name` tag to add a title to the poll, but it's opti
   "kind": 1,
   "tags": [
     ...
-    ["poll", "Option 1", "Option 2", "Option 3"],
-    ["poll_name", "This is optional"]
+    ["poll", "single", "0", "I'm a title!", "Option 1", "Option 2", "Option 3"],
     ...
   ],
 }
@@ -43,7 +41,10 @@ The format of the event is the following:
 
 ```json
 kind: 9
-content: <choice, which is the index of the option | the first option is 0>
+content: <reason for voting> // Can be empty string
+tag: poll_r // for poll response
+options:
+  - [<choices>]: array of index of the option | the first option is 0
 ```
 
 #### Example - Vote
@@ -54,10 +55,13 @@ content: <choice, which is the index of the option | the first option is 0>
   "kind": 9,
   "tags": [
     ...
-    ["e", "<event-id>"]
+    ["e", "<event-id>"],
+    ["poll_r", "0"],
+    // OR
+    ["poll_r", "0", "2"]
     ...
   ],
-  "content": "1"
+  "content": "reason for voting"
 }
 ```
 
@@ -68,6 +72,7 @@ content: <choice, which is the index of the option | the first option is 0>
 - Clients should display poll options if more than **one option** is present in the poll
 - Clients should ignore vote events if the poll is **expired**
 - Clients should not display more than one poll per message. The first poll in the message should be displayed.
+- Poll title should be displayed if present and should be limited to 25 chars
 
 ## Warning
 

From 0b4fe77b8c9551835fc637688e52386f43c62d68 Mon Sep 17 00:00:00 2001
From: Thomas <31560900+0xtlt@users.noreply.github.com>
Date: Tue, 28 Feb 2023 09:44:16 +0100
Subject: [PATCH 4/4] Highlights

---
 41.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/41.md b/41.md
index 90859d95c2..8fb057ca6f 100644
--- a/41.md
+++ b/41.md
@@ -11,7 +11,7 @@
 
 To create a poll, include a `poll` tag in the message event. with the following format:
 
-```json
+```text
 tag: poll
 options:
  - <multi|single> allow others to reply with one or multiple options
@@ -39,7 +39,7 @@ options:
 To vote for a poll, you have to send an event kind `9`.\
 The format of the event is the following:
 
-```json
+```text
 kind: 9
 content: <reason for voting> // Can be empty string
 tag: poll_r // for poll response