From ae65fb9b19e7dbf87173cc4e1265d89e88c8893e Mon Sep 17 00:00:00 2001
From: Benoit Joly <benoit@benoitj.ca>
Date: Tue, 21 Jul 2020 00:56:43 -0400
Subject: [PATCH] Adding details around listing and deleting proofs

notation related commands are quite obscur. listing and deleting proofs are not
that easy to find.
---
 views/guides.php                              |  6 ++++
 .../managing-proofs-deleting.content.php      | 32 +++++++++++++++++++
 .../guides/managing-proofs-deleting.title.php |  1 +
 .../managing-proofs-listing.content.php       | 23 +++++++++++++
 .../guides/managing-proofs-listing.title.php  |  1 +
 5 files changed, 63 insertions(+)
 create mode 100644 views/guides/managing-proofs-deleting.content.php
 create mode 100644 views/guides/managing-proofs-deleting.title.php
 create mode 100644 views/guides/managing-proofs-listing.content.php
 create mode 100644 views/guides/managing-proofs-listing.title.php

diff --git a/views/guides.php b/views/guides.php
index 59d622f..bdb0b82 100644
--- a/views/guides.php
+++ b/views/guides.php
@@ -39,5 +39,11 @@
             <a href="/guides/feature-comparison-keybase">Feature comparison with Keybase</a><br>
             <a href="/guides/migrating-from-keybase">Migrating from Keybase</a><br>
         </div>
+
+        <div class="guides__section">
+            <h3>Managing proofs in GnuPG</h3>
+            <a href="/guides/managing-proofs-listing">Listing proofs</a><br>
+            <a href="/guides/managing-proofs-deleting">Deleting proofs</a><br>
+        </div>
     </div>
 </div>
diff --git a/views/guides/managing-proofs-deleting.content.php b/views/guides/managing-proofs-deleting.content.php
new file mode 100644
index 0000000..9eb2a64
--- /dev/null
+++ b/views/guides/managing-proofs-deleting.content.php
@@ -0,0 +1,32 @@
+<p>Over time, you may need to delete proofs. Changing proofs can be achieved by deleting proofs and adding new ones.</p>
+
+<h3>Delete all proofs</h3>
+
+<p>First, edit the key (make sure to replace FINGERPRINT):</p>
+<code>gpg --edit-key FINGERPRINT</code>
+
+<p>Launch the notation prompt</p>
+<code>notation</code>
+
+<p>Enter the 'none' notation to delete all notations</p>
+<code>none</code>
+
+<p>Save the changes</p>
+<code>save</code>
+
+<h3>Delete one of your proofs</h3>
+
+<p>First, edit the key (make sure to replace FINGERPRINT):</p>
+<code>gpg --edit-key FINGERPRINT</code>
+
+<p>Launch the notation prompt</p>
+<code>notation</code>
+
+<p>In this case, you need to start with <b>-</b> followed by the proof you want to delete. Make sure you type the proof exactly like it is in your key.</p>
+<code>-proof@metacode.biz=dns:yourdomain.org?type=TXT</code>
+
+<p>Save the changes</p>
+<code>save</code>
+
+<h3>Publish your key changes</h3>
+<p>Like adding new proofs, you most probably want to publish your changes to WKD or to a keyserver like <a href="keys.openpgp.org">keys.openpgp.org</a>
diff --git a/views/guides/managing-proofs-deleting.title.php b/views/guides/managing-proofs-deleting.title.php
new file mode 100644
index 0000000..62440b4
--- /dev/null
+++ b/views/guides/managing-proofs-deleting.title.php
@@ -0,0 +1 @@
+Deleting Proofs using GnuPG
diff --git a/views/guides/managing-proofs-listing.content.php b/views/guides/managing-proofs-listing.content.php
new file mode 100644
index 0000000..329ea35
--- /dev/null
+++ b/views/guides/managing-proofs-listing.content.php
@@ -0,0 +1,23 @@
+<p>Now that we have proofs on our OpenPGP keys, lets list them.</p>
+
+<h3>Listing notations in GnuPG</h3>
+
+<p>First, edit the key (make sure to replace FINGERPRINT):</p>
+<code>gpg --edit-key FINGERPRINT</code>
+
+<p>List detailed prefs:</p>
+<code>showpref</code>
+
+<p>You should now see your key details, uid, and proofs assigned to your keys</p>
+<code>
+[ultimate] (1). Your Name <your@email>
+     Cipher: AES256, AES192, AES, 3DES
+     Digest: SHA512, SHA384, SHA256, SHA1
+     Compression: ZLIB, BZIP2, ZIP, Uncompressed
+     Features: MDC, Keyserver no-modify
+     Notations: proof@metacode.biz=https://gist.github.com/youruser/somehash
+                proof@metacode.biz=dns:yourdomain.org?type=TXT
+</code>
+
+<p>Exit gpg</p>
+<code>quit</code>
diff --git a/views/guides/managing-proofs-listing.title.php b/views/guides/managing-proofs-listing.title.php
new file mode 100644
index 0000000..33308f0
--- /dev/null
+++ b/views/guides/managing-proofs-listing.title.php
@@ -0,0 +1 @@
+Listing Proofs using GnuPG