diff --git a/crates/header-translator/src/id.rs b/crates/header-translator/src/id.rs
index 86f5f75c4..f4bd7bbb3 100644
--- a/crates/header-translator/src/id.rs
+++ b/crates/header-translator/src/id.rs
@@ -375,6 +375,22 @@ impl ItemIdentifier {
 
         ItemIdentifierPathInRelationTo(self, other)
     }
+
+    /// Generate a markdown link to Apple's documentation.
+    ///
+    /// This is best effort only, and doesn't work for functions and methods,
+    /// and possibly some renamed classes and traits. Additionally, the link
+    /// may redirect.
+    pub(crate) fn doc_link(&self) -> impl fmt::Display + '_ {
+        FormatterFn(|f| {
+            write!(
+                f,
+                "[Apple's documentation](https://developer.apple.com/documentation/{}/{}?language=objc)",
+                self.library_name().to_lowercase(),
+                self.name.to_lowercase()
+            )
+        })
+    }
 }
 
 impl ItemIdentifier<Option<String>> {
diff --git a/crates/header-translator/src/stmt.rs b/crates/header-translator/src/stmt.rs
index 746e71797..8de27125a 100644
--- a/crates/header-translator/src/stmt.rs
+++ b/crates/header-translator/src/stmt.rs
@@ -1659,6 +1659,7 @@ impl Stmt {
                     }
 
                     writeln!(f, "extern_class!(")?;
+                    writeln!(f, "    /// {}", id.doc_link())?;
                     write!(f, "    #[unsafe(super(")?;
                     for (i, (superclass, generics)) in superclasses.iter().enumerate() {
                         if 0 < i {
@@ -1977,6 +1978,7 @@ impl Stmt {
                 } => {
                     writeln!(f, "extern_protocol!(")?;
 
+                    writeln!(f, "    /// {}", id.doc_link())?;
                     write!(f, "    {}", self.cfg_gate_ln(config))?;
                     write!(f, "    {availability}")?;
                     write!(f, "    pub unsafe trait {}", id.name)?;
@@ -2048,6 +2050,7 @@ impl Stmt {
                     fields,
                     sendable,
                 } => {
+                    writeln!(f, "/// {}", id.doc_link())?;
                     write!(f, "{}", self.cfg_gate_ln(config))?;
                     write!(f, "{availability}")?;
                     write!(f, "#[repr(C)]")?;
@@ -2103,6 +2106,8 @@ impl Stmt {
                     variants,
                     sendable,
                 } => {
+                    writeln!(f, "/// {}", id.doc_link())?;
+
                     match kind {
                     // TODO: Once Rust gains support for more precisely
                     // specifying niches, use that to convert this into a
@@ -2265,6 +2270,7 @@ impl Stmt {
                     value,
                     is_last,
                 } => {
+                    writeln!(f, "/// {}", id.doc_link())?;
                     write!(f, "{}", self.cfg_gate_ln(config))?;
                     write!(f, "{availability}")?;
                     write!(f, "pub const {}: {} = {value};", id.name, ty.enum_())?;
@@ -2279,8 +2285,9 @@ impl Stmt {
                     value: None,
                 } => {
                     writeln!(f, "extern \"C\" {{")?;
+                    writeln!(f, "    /// {}", id.doc_link())?;
                     write!(f, "{}", self.cfg_gate_ln(config))?;
-                    writeln!(f, "pub static {}: {};", id.name, ty.var())?;
+                    writeln!(f, "    pub static {}: {};", id.name, ty.var())?;
                     writeln!(f, "}}")?;
                 }
                 Self::VarDecl {
@@ -2289,6 +2296,7 @@ impl Stmt {
                     ty,
                     value: Some(expr),
                 } => {
+                    writeln!(f, "/// {}", id.doc_link())?;
                     write!(f, "{}", self.cfg_gate_ln(config))?;
                     write!(f, "pub static {}: {} = ", id.name, ty.var())?;
 
@@ -2385,6 +2393,7 @@ impl Stmt {
                     ty,
                     kind,
                 } => {
+                    writeln!(f, "/// {}", id.doc_link())?;
                     match kind {
                         Some(UnexposedAttr::TypedEnum) => {
                             // TODO: Handle this differently
diff --git a/crates/test-ui/ui/implement_protocol_missing_super.stderr b/crates/test-ui/ui/implement_protocol_missing_super.stderr
index 2e4c1eeac..7464eb342 100644
--- a/crates/test-ui/ui/implement_protocol_missing_super.stderr
+++ b/crates/test-ui/ui/implement_protocol_missing_super.stderr
@@ -18,10 +18,10 @@ note: required by a bound in `NSURLSessionDelegate`
  --> $WORKSPACE/framework-crates/objc2-foundation/src/generated/NSURLSession.rs
   |
   | / extern_protocol!(
+  | |     /// [Apple's documentation](https://developer.apple.com/documentation/foundation/nsurlsessiondelegate?language=objc)
   | |     pub unsafe trait NSURLSessionDelegate: NSObjectProtocol {
   | |                      -------------------- required by a bound in this trait
   | |         #[cfg(feature = "NSError")]
-  | |         #[optional]
 ... |
   | |     unsafe impl ProtocolType for dyn NSURLSessionDelegate {}
   | | );
diff --git a/generated b/generated
index b8b22e83e..4307f93fc 160000
--- a/generated
+++ b/generated
@@ -1 +1 @@
-Subproject commit b8b22e83e6d16cdeff39cfc43224900bccec8bdf
+Subproject commit 4307f93fcc1b73c6d8f85dd530cbc4137e8de57a