From 7e5e016982a0852f4151c434890102d733eedeba Mon Sep 17 00:00:00 2001
From: Brad Warren <bmw@eff.org>
Date: Thu, 23 Jun 2016 17:10:03 -0700
Subject: [PATCH] Document that only save should make checkpoints

---
 certbot/interfaces.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/certbot/interfaces.py b/certbot/interfaces.py
index a6f0b9735..2bc25723c 100644
--- a/certbot/interfaces.py
+++ b/certbot/interfaces.py
@@ -241,6 +241,11 @@ class IInstaller(IPlugin):
 
     Represents any server that an X509 certificate can be placed.
 
+    It is assumed that :func:`save` is the only method that finalizes a
+    checkpoint. This is important to ensure that checkpoints are
+    restored in a consistent manner if requested by the user or in case
+    of an error.
+
     """
 
     def get_all_names():