Rename `desc` to `terms`

1 files changed, 5 insertions, 0 deletions

diff --git a/library/src/meta/link.rs b/library/src/meta/link.rs
index 60d57a5f..ebb7a7e9 100644
--- a/library/src/meta/link.rs
+++ b/library/src/meta/link.rs
@@ -13,12 +13,17 @@ use crate::text::TextNode;
 /// ```
 /// #show link: underline
 ///
+/// https://example.com \
 /// #link("https://example.com") \
 /// #link("https://example.com")[
 ///   See example.com
 /// ]
 /// ```
 ///
+/// ## Syntax
+/// This function also has dedicated syntax: Text that starts with `http://` or
+/// `https://` is automatically turned into a link.
+///
 /// ## Parameters
 /// - dest: Destination (positional, required)
 ///   The destination the link points to.