diff --git a/docs/server/source/data-models/vote-model.md b/docs/server/source/data-models/vote-model.md
index 25d5029c..daa66a94 100644
--- a/docs/server/source/data-models/vote-model.md
+++ b/docs/server/source/data-models/vote-model.md
@@ -4,17 +4,24 @@ A vote has the following structure:
 
 ```json
 {
-    "id": "<RethinkDB-generated ID for the vote>",
-    "node_pubkey": "<the public key of the voting node>",
+    "node_pubkey": "<The public key of the voting node>",
     "vote": {
-        "voting_for_block": "<id of the block the node is voting for>",
-        "previous_block": "<id of the block previous to this one>",
-        "is_block_valid": "<true|false>",
-        "invalid_reason": "<None|DOUBLE_SPEND|TRANSACTIONS_HASH_MISMATCH|NODES_PUBKEYS_MISMATCH",
+        "voting_for_block": "<ID of the block the node is voting on>",
+        "previous_block": "<ID of the block previous to the block being voted on>",
+        "is_block_valid": "<true OR false>",
+        "invalid_reason": null,
         "timestamp": "<Unix time when the vote was generated, provided by the voting node>"
     },
-    "signature": "<signature of vote>"
+    "signature": "<Cryptographic signature of vote>"
 }
 ```
 
-Note: The `invalid_reason` was not being used and may be dropped in a future version of BigchainDB. See [Issue #217](https://github.com/bigchaindb/bigchaindb/issues/217) on GitHub.
+**Notes**
+
+* Votes have no ID (or `"id"`), as far as users are concerned. (The backend database uses one internally, but it's of no concern to users and it's never reported to them via BigchainDB APIs.)
+
+* At the time of writing, the value of `"invalid_reason"` was always `null`. In other words, it wasn't being used. It may be used or dropped in a future version of BigchainDB. See [Issue #217](https://github.com/bigchaindb/bigchaindb/issues/217) on GitHub.
+
+* For more information about the vote `"timestamp"`, see [the page about timestamps in BigchainDB](https://docs.bigchaindb.com/en/latest/timestamps.html).
+
+* For more information about how the `"signature"` is calculated, see [the page about cryptography in BigchainDB](../appendices/cryptography.html).