From d25619444bd0b436fd3920f877c443cd16b742f5 Mon Sep 17 00:00:00 2001
From: Chris Murphy <chrismurphy@fedoraproject.org>
Date: May 28 2020 18:31:36 +0000
Subject: formatting 1


---

diff --git a/hibernationstatus.md b/hibernationstatus.md
index 238d7f5..8d1e5c7 100644
--- a/hibernationstatus.md
+++ b/hibernationstatus.md
@@ -2,20 +2,24 @@
 
 2020-05-28
 
-**Synopsis:** The Fedora Workstation working group recognizes hibernation can be useful, but due to impediments it's currently not practical to support it. This is a recognition of the current state of affairs, but the working group wishes hibernation could be relied upon, and thinks there is a viable approach for limited support of hibernation in the future. We encourage interested parties to pursue the needed improvements. In the meantime, Workstation Edition won't be constrained by the current status. There are desired enhancements to performance and security that are hindered by the status quo. The working group will re-evaluate when the significant impediments have been adequately addressed.
+**Synopsis:**
+The Fedora Workstation working group recognizes hibernation can be useful, but due to impediments it's currently not practical to support it. This is a recognition of the current state of affairs, but the working group wishes hibernation could be relied upon, and thinks there is a viable approach for limited support of hibernation in the future. We encourage interested parties to pursue the needed improvements. In the meantime, Workstation Edition won't be constrained by the current status. There are desired enhancements to performance and security that are hindered by the status quo. The working group will re-evaluate when the significant impediments have been adequately addressed.
 
 We would like to see an install time means of enabling hibernation retained via Custom partitioning. If the user chooses to create a swap partition, the installer will include a resume=UUID kernel parameter hint so that the kernel can find the hibernation image.
 
 **Prior discussions in Fedora:**
+
 - Support for hibernation 1/2: background and summary 2020-02-09 [1]
 - Support for hibernation 2/2: questions 2020-02-09 [1]
 
 **Working hibernation is helpful:**
+
 - less power consumption than S0 or S3;
 - even if resume is slower than boot, it can be faster at restoring the user's prior working environment;
 - avoids data loss in low battery situations, the alternative is power off or suspend-to-RAM followed by power off when the battery arrives at 0%, both of which are often abrupt.
 
 **Alternatives:**
+
 - Windows and macOS favor Modern Standby and Power Nap, a.k.a. S0 low power idle [2];
 - Short waits, and cpuidle [3];
 - application autosave and recover statefulness.
@@ -25,6 +29,7 @@ We would like to see an install time means of enabling hibernation retained via 
 *Note 2:* There is a pernicious problem with laptop batteries. As they age, they often won't tolerate load very well, leading to rapid discharge and very short or no notice before a compulsory power off. In such cases, even when the system is hibernation capable, hibernation can fail. Power can be lost during hibernation entry. There isn't much software can do to second guess the commonly confused state of aged batteries.
 
 **Current significant impediments:**
+
 - UEFI Secure Boot is overwhelmingly present and enabled by default on new computers; 
 - kernel lockdown policy inhibits hibernation when Secure Boot is enabled;
 - ACPI bugs can be transient and difficult to fix or work around; hibernation can mean data loss due to failed entry or exit;
@@ -32,9 +37,11 @@ We would like to see an install time means of enabling hibernation retained via 
 - large swap partition exacerbates performance problems in swap heavy workloads.
 
 **Necessary enhancements to hibernation:**
+
 - signed and encrypted hibernation image [4];
 
 **Nice to have enhancements to hibernation:**
+
 - dynamic swapfiles created and enabled prior to hibernation entry [5];
 - single interface for determining the location of the hibernation image for all file systems [6]
 - TPM2 support, or alternative, for storing the key(s) needed to resume.
@@ -70,7 +77,7 @@ https://pagure.io/fedora-workstation/issue/120#comment-618549
 https://github.com/systemd/systemd/issues/11939#issuecomment-471684411
 
 
-Appendix
+**Appendix**
 
 Hibernation in the cloud
 https://lwn.net/Articles/821158/