From 9ac9e2dec5c9d685795c2e1e9f6767efb49a0c62 Mon Sep 17 00:00:00 2001
From: Stuart Mumford <stuart@cadair.com>
Date: Thu, 19 Mar 2026 17:09:27 +0000
Subject: [PATCH] docs on trusted publishing

---
 docs/index.rst |  1 +
 docs/sunpy.rst | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 docs/sunpy.rst

diff --git a/docs/index.rst b/docs/index.rst
index 70ae5eb..bff65c4 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -16,6 +16,7 @@ This guide is intended to explain modern Python packaging, it covers most of the
    data
    ci
    advanced/index
+   sunpy
 
 Using the Template
 ==================
diff --git a/docs/sunpy.rst b/docs/sunpy.rst
new file mode 100644
index 0000000..8bfbcd6
--- /dev/null
+++ b/docs/sunpy.rst
@@ -0,0 +1,25 @@
+.. _sunpy-specific:
+
+======================
+SunPy Package Template
+======================
+
+This page is notes for maintainers of packages using the sunpy package template, it mostly talks about how to configure things the package template is expecting.
+
+``ci.yml``
+==========
+
+Publishing
+----------
+
+The package template uses Trusted Publishing to push to PyPI.
+This requires two things to be configured.
+Firstly, a GitHub environment which needs to be named ``pypi`` and should implement a pattern which matches tags for your releases (i.e. ``v*``).
+Secondly, you need to configure PyPI to know about this environment and accept releases from it.
+Todo this go to ``https://pypi.org/manage/project/<project_name>/settings/publishing/`` and enter the details, this is probably:
+
+* **Owner**: ``sunpy``
+* **Workflow name**: ``ci.yml``
+* **Environment name**: ``pypi``
+
+