From ccbf4ab84d70d6f3174eafa0d2975c0484c83e57 Mon Sep 17 00:00:00 2001
From: Paul Schaub <vanitasvitae@fsfe.org>
Date: Fri, 21 Jul 2023 16:55:21 +0200
Subject: [PATCH] Add documentation to CertificateAuthority

---
 .../pgpainless/authentication/CertificateAuthority.java    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/pgpainless-core/src/main/java/org/pgpainless/authentication/CertificateAuthority.java b/pgpainless-core/src/main/java/org/pgpainless/authentication/CertificateAuthority.java
index 01b1a6bc8..d124902d9 100644
--- a/pgpainless-core/src/main/java/org/pgpainless/authentication/CertificateAuthority.java
+++ b/pgpainless-core/src/main/java/org/pgpainless/authentication/CertificateAuthority.java
@@ -10,6 +10,13 @@
 import java.util.Date;
 import java.util.List;
 
+/**
+ * Interface for a CA that can authenticate trust-worthy certificates.
+ * Such a CA might be a fixed list of trustworthy certificates, or a dynamic implementation like the Web-of-Trust.
+ *
+ * @see <a href="https://github.com/pgpainless/pgpainless-wot">PGPainless-WOT</a>
+ * @see <a href="https://sequoia-pgp.gitlab.io/sequoia-wot/">OpenPGP Web of Trust</a>
+ */
 public interface CertificateAuthority {
 
     /**