From 7e38d203ce9ed7e609b7a13d5f49a29563f27bc8 Mon Sep 17 00:00:00 2001
From: Paul Hauner <paul@paulhauner.com>
Date: Wed, 9 Feb 2022 07:44:42 +0000
Subject: [PATCH] Add "update priority" (#2988)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Issue Addressed

NA

## Proposed Changes

Add the "Update Priority" section which has featured in many of our previous releases (e.g., [Poñeta](https://github.com/sigp/lighthouse/releases/v2.1.1)).

Previously this section has been copied in manually.

## Additional Info

NA
---
 .github/workflows/release.yml       | 13 +++++++++++++
 book/src/SUMMARY.md                 |  1 +
 book/src/installation-priorities.md | 22 ++++++++++++++++++++++
 3 files changed, 36 insertions(+)
 create mode 100644 book/src/installation-priorities.md

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 5b28a5ec7..a46fed81d 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -232,6 +232,19 @@ jobs:
 
                   Add a summary.
 
+                  ## Update Priority
+
+                  This table provides priorities for which classes of users should update particular components.
+
+                  |User Class |Beacon Node  | Validator Client|
+                  --- | --- | ---
+                  |Staking Users| <TODO> | <TODO> |
+                  |Non-Staking Users| <TODO>|---|
+
+                  *See [Update
+                  Priorities](https://lighthouse-book.sigmaprime.io/installation-priorities.html)
+                  more information about this table.*
+
                   ## All Changes
 
                   ${{ steps.changelog.outputs.CHANGELOG }}
diff --git a/book/src/SUMMARY.md b/book/src/SUMMARY.md
index ee0ecb86a..f719a3a2b 100644
--- a/book/src/SUMMARY.md
+++ b/book/src/SUMMARY.md
@@ -11,6 +11,7 @@
     * [Raspberry Pi 4](./pi.md)
     * [Cross-Compiling](./cross-compiling.md)
     * [Homebrew](./homebrew.md)
+    * [Update Priorities](./installation-priorities.md)
 * [Key Management](./key-management.md)
     * [Create a wallet](./wallet-create.md)
     * [Create a validator](./validator-create.md)
diff --git a/book/src/installation-priorities.md b/book/src/installation-priorities.md
new file mode 100644
index 000000000..69d871c39
--- /dev/null
+++ b/book/src/installation-priorities.md
@@ -0,0 +1,22 @@
+# Update Priorities
+
+When publishing releases, Lighthouse will include an "Update Priority" section in the release notes. As an example, see the [release notes from v2.1.2](https://github.com/sigp/lighthouse/releases/tag/v2.1.2)).
+
+The "Update Priority" section will include a table which may appear like so:
+
+|User Class |Beacon Node  | Validator Client|
+--- | --- | ---
+|Staking Users| Medium Priority | Low Priority |
+|Non-Staking Users| Low Priority|---|
+
+To understand this table, the following terms are important:
+
+- *Staking users* are those who use `lighthouse bn` and `lighthouse vc` to stake on the Beacon Chain.
+- *Non-staking users* are those who run a `lighthouse bn` for non-staking purposes (e.g., data analysis or applications).
+- *High priority* updates should be completed as soon as possible (e.g., hours or days).
+- *Medium priority* updates should be completed at the next convenience (e.g., days or a week).
+- *Low priority* updates should be completed in the next routine update cycle (e.g., two weeks).
+
+Therefore, in the table above, staking users should update their BN in the next days or week and
+their VC in the next routine update cycle. Non-staking should also update their BN in the next
+routine update cycle.