docs(ghostkey): warn users to back up keys before importing#29
Merged
Conversation
The Ghostkey Vault delegate is still early software and keys have been observed disappearing from the vault. Add prominent warnings on the FAQ, create, and success pages instructing users to back up both the certificate and signing key before clicking "Import to Freenet". Refs freenet/ghostkeys#3. [AI-assisted - Claude]
sanity
added a commit
that referenced
this pull request
Apr 13, 2026
The backup warning was added to three places in PR #29: the FAQ, the create/donate page, and the success page. Feedback: the warning only matters at the moment the user is actually shown their freshly created key, which is the success page. Putting it on the FAQ and donate pages is noise that dilutes the message when it matters. Remove the warning block from /ghostkey/ (FAQ) and /ghostkey/create/ (donate). Restore the original "Storage, backup, and the CLI" prose on the FAQ page. The stronger success-page warning is unchanged. [AI-assisted - Claude]
sanity
added a commit
that referenced
this pull request
Apr 13, 2026
The backup warning was added to three places in PR #29: the FAQ, the create/donate page, and the success page. Feedback: the warning only matters at the moment the user is actually shown their freshly created key, which is the success page. Putting it on the FAQ and donate pages is noise that dilutes the message when it matters. Remove the warning block from /ghostkey/ (FAQ) and /ghostkey/create/ (donate). Restore the original "Storage, backup, and the CLI" prose on the FAQ page. The stronger success-page warning is unchanged. [AI-assisted - Claude]
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The Ghostkey Vault delegate is still early software and users have reported keys disappearing from the vault after import (freenet/ghostkeys#3). Without a backup the donation behind the key is lost.
Approach
Add prominent warnings to all three ghostkey pages:
/ghostkey/(FAQ): warning banner near the top plus strengthened storage section/ghostkey/create/: warning above the donation form/ghostkey/success/: reordered "What's Next?" to put backup first, import second, with an explicit warning calloutEach warning links to freenet/ghostkeys#3 so users can track progress.
Testing
Content-only changes; verified markdown renders correctly by inspection. No code changes.
Refs freenet/ghostkeys#3.
[AI-assisted - Claude]