diff --git a/README.md b/README.md
index 8913b4f..0eb75ff 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,10 @@
 # rage: Rust implementation of age
 
-age is a simple, secure and modern encryption tool with small explicit keys, no
-config options, and UNIX-style composability. The format specification is at
-[age-encryption.org/v1](https://age-encryption.org/v1).
-
-rage is a Rust implementation of the age tool. It is pronounced like the Japanese
-[らげ](https://translate.google.com/#view=home&op=translate&sl=ja&tl=en&text=%E3%82%89%E3%81%92)
-(with a hard g).
+rage is a simple, modern, and secure file encryption tool, using the *age*
+format. It features small explicit keys, no config options, and UNIX-style
+composability.
 
+The format specification is at [age-encryption.org/v1](https://age-encryption.org/v1).
 To discuss the spec or other age related topics, please email
 [the mailing list](https://groups.google.com/d/forum/age-dev) at
 age-dev@googlegroups.com. age was designed by
@@ -88,8 +85,6 @@ $ rage -r "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIIZDRcvS8PnhXr30WKSKmf7WKKi92ACUa
 $ rage -d -i ~/.ssh/id_ed25519 example.png.age > example.png
 ```
 
-`ssh-rsa` support is currently behind the `unstable` feature flag.
-
 Note that SSH key support employs more complex cryptography, and embeds a public
 key tag in the encrypted file, making it possible to track files that are
 encrypted to a specific public key.
@@ -124,6 +119,9 @@ Help from new packagers is very welcome.
   ZIP archives as read-only. It is currently only usable on Unix systems, as it
   relies on `libfuse`.
 
+- `ssh` (enabled by default) enables support for reusing existing SSH key files
+  for age encryption.
+
 - `unstable` enables in-development functionality. Anything behind this feature
   flag has no stability or interoperability guarantees.
 
diff --git a/age-core/README.md b/age-core/README.md
index 37208f8..3f0ab02 100644
--- a/age-core/README.md
+++ b/age-core/README.md
@@ -1,9 +1,10 @@
 # age-core Rust library
 
-This crate contains common functions used across the `age` crates.
+This crate contains common structs and functions used across the `age` crates.
 
 You are probably looking for the [`age`](https://crates.io/crates/age) crate
-itself.
+itself. You should only need to directly depend on this crate if you are
+implementing a custom recipient type.
 
 ## License
 
diff --git a/age/README.md b/age/README.md
index 4433f80..bc438e5 100644
--- a/age/README.md
+++ b/age/README.md
@@ -1,9 +1,15 @@
 # age Rust library
 
-age is a simple, secure and modern encryption tool with small explicit keys, no
-config options, and UNIX-style composability. The format specification is at
-[age-encryption.org/v1](https://age-encryption.org/v1).
+age is a simple, modern, and secure file encryption library. It features small
+explicit keys, no config options, and UNIX-style composability.
 
+This crate provides a set of Rust APIs that can be used to build more complex
+tools based on the age format. The primary consumers of these APIs are the
+[`rage`](https://crates.io/crates/rage) CLI tools, which provide straightforward
+encryption and decryption of files or streams (e.g. in shell scripts), as well
+as additional features such as mounting an encrypted archive.
+
+The format specification is at [age-encryption.org/v1](https://age-encryption.org/v1).
 To discuss the spec or other age related topics, please email
 [the mailing list](https://groups.google.com/d/forum/age-dev) at
 age-dev@googlegroups.com. age was designed by
@@ -25,8 +31,16 @@ See the [documentation](https://docs.rs/age) for examples.
 
 ### Feature flags
 
+- `armor` enables the `age::armor` module, which provides support for
+  ASCII-armored age files.
+
+- `async` enables asynchronous APIs for encryption and decryption.
+
 - `cli-common` enables common helper functions for building age CLI tools.
 
+- `ssh` enables the `age::ssh` module, which allows for reusing existing SSH key
+  files for age encryption.
+
 - `unstable` enables in-development functionality. Anything behind this feature
   flag has no stability or interoperability guarantees.
 
diff --git a/rage/Cargo.toml b/rage/Cargo.toml
index d79d84a..71168a7 100644
--- a/rage/Cargo.toml
+++ b/rage/Cargo.toml
@@ -14,7 +14,7 @@ default-run = "rage"
 [package.metadata.deb]
 name = "rage"
 extended-description = """\
-age is a simple, secure and modern encryption format with small explicit keys, \
+age is a simple, modern, and secure encryption format with small explicit keys, \
 no config options, and UNIX-style composability. rage is a Rust implementation \
 of the age specification."""
 section = "utils"