From 876efa039b585b3c72c69de391edeca37573c479 Mon Sep 17 00:00:00 2001
From: Tim <0xtimc@gmail.com>
Date: Wed, 16 Oct 2024 21:05:48 +0100
Subject: [PATCH 1/2] Add initial DocC scaffolding

---
 Sources/Crypto/Docs.docc/index.md        | 12 ++++++++++++
 Sources/_CryptoExtras/Docs.docc/index.md |  5 +++++
 2 files changed, 17 insertions(+)
 create mode 100644 Sources/Crypto/Docs.docc/index.md
 create mode 100644 Sources/_CryptoExtras/Docs.docc/index.md

diff --git a/Sources/Crypto/Docs.docc/index.md b/Sources/Crypto/Docs.docc/index.md
new file mode 100644
index 00000000..e44b543b
--- /dev/null
+++ b/Sources/Crypto/Docs.docc/index.md
@@ -0,0 +1,12 @@
+# ``Crypto``
+
+A cryptography library for Swift.
+
+## Overview
+
+Swift Crypto provides a Swift library for common cryptographic operations. It is available as a Swift package and provides two main libraries:
+
+* `Crypto` - an open-source implementation of a substantial portion of the API of [Apple CryptoKit](https://developer.apple.com/documentation/cryptokit) suitable for use on Linux platforms. It enables cross-platform or server applications with the advantages of CryptoKit.
+* `CryptoExtras` - a collection of additional cryptographic primitives and utilities that are not part of CryptoKit but useful in a server environment.
+
+Swift Crypto is built on top of [BoringSSL](https://boringssl.googlesource.com/boringssl/), Google's fork of OpenSSL. The current features of Swift Crypto cover key exchange, key derivation, encryption and decryption, hashing, message authentication, and more.
\ No newline at end of file
diff --git a/Sources/_CryptoExtras/Docs.docc/index.md b/Sources/_CryptoExtras/Docs.docc/index.md
new file mode 100644
index 00000000..310cf0dd
--- /dev/null
+++ b/Sources/_CryptoExtras/Docs.docc/index.md
@@ -0,0 +1,5 @@
+# ``CryptoExtras``
+
+Provides additional cryptographic APIs that are not available in CryptoKit (and therefore the core Crypto library).
+
+

From 3906c7044b6b680c18e303b4be8feb0942439ad6 Mon Sep 17 00:00:00 2001
From: Tim <0xtimc@gmail.com>
Date: Wed, 16 Oct 2024 21:06:36 +0100
Subject: [PATCH 2/2] Add SPI file

---
 .spi.yml | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 .spi.yml

diff --git a/.spi.yml b/.spi.yml
new file mode 100644
index 00000000..238c9686
--- /dev/null
+++ b/.spi.yml
@@ -0,0 +1,4 @@
+version: 1
+builder:
+  configs:
+    - documentation_targets: [Crypto, _CryptoExtras]
\ No newline at end of file