From 2b97e03cf654e6349a53d9109a576976d08a2acb Mon Sep 17 00:00:00 2001
From: Anton Kaliaev <anton.kalyaev@gmail.com>
Date: Thu, 30 Jul 2020 13:07:03 +0400
Subject: [PATCH] docs: document canonical field (#5166)

Closes #2769

Spec PR: https://github.com/tendermint/spec/pull/125
---
 rpc/swagger/swagger.yaml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/rpc/swagger/swagger.yaml b/rpc/swagger/swagger.yaml
index 780939732..30e2a4615 100644
--- a/rpc/swagger/swagger.yaml
+++ b/rpc/swagger/swagger.yaml
@@ -709,7 +709,10 @@ paths:
         Get Commit.
       responses:
         200:
-          description: Commit results.
+          description: |
+            Commit results.
+
+            canonical switches from false to true for block H once block H+1 has been committed. Until then it's subjective and only reflects what this node has seen so far.
           content:
             application/json:
               schema: