update

crates/workspace/src/views/repo_detail/about.rs

@@ -7,8 +7,8 @@ use signed_core::Announcement;
 use signed_state::ProfileStore;
 use signed_ui::{UserAvatar, middle_truncate};
 
-/// Open the "About" dialog: every field of the repository's announcement
-/// event (NIP-34, kind 30617), as parsed into [`Announcement`].
+/// Open the About dialog showing every field of the announcement event.
+/// The event is NIP-34 kind 30617, parsed into [`Announcement`].
 pub(super) fn open_about_dialog(announcement: Announcement, window: &mut Window, cx: &mut App) {
     window.open_dialog(cx, move |dialog, _window, cx| {
         let announcement = announcement.clone();
@@ -22,8 +22,8 @@ pub(super) fn open_about_dialog(announcement: Announcement, window: &mut Window,
     });
 }
 
-/// The announcement's fields as labeled rows; hex identifiers carry a copy
-/// button, multi-value tags one line per value.
+/// The announcement's fields as labeled rows.
+/// Hex identifiers carry a copy button, multi-value tags one line per value.
 fn announcement_rows(announcement: &Announcement, cx: &App) -> AnyElement {
     let mut rows: Vec<AnyElement> = Vec::new();
 
@@ -116,7 +116,7 @@ fn announcement_rows(announcement: &Announcement, cx: &App) -> AnyElement {
     v_flex().gap_3().w_full().children(rows).into_any_element()
 }
 
-/// One info row: a small muted label above the value.
+/// One info row with a small muted label above the value.
 fn row(label: &'static str, value: AnyElement, cx: &App) -> AnyElement {
     v_flex()
         .gap_1()
@@ -159,8 +159,9 @@ fn copy_value(id: &'static str, value: String, cx: &App) -> AnyElement {
         .into_any_element()
 }
 
-/// One row per maintainer: avatar and display name (falling back to a
-/// shortened npub), with a copy button for the full pubkey.
+/// One row per maintainer with avatar and display name.
+/// The display name falls back to a shortened npub.
+/// A copy button copies the full pubkey.
 fn maintainers(maintainers: &[PublicKey], cx: &App) -> AnyElement {
     let profile_store = ProfileStore::global(cx);
     v_flex()
@@ -190,8 +191,8 @@ fn maintainers(maintainers: &[PublicKey], cx: &App) -> AnyElement {
         .into_any_element()
 }
 
-/// One row per item of a multi-value tag: the value is truncated to a single
-/// line, with a copy button that copies the full value.
+/// One row per item of a multi-value tag.
+/// The value is truncated to a single line, with a copy button for the full value.
 fn list(id: &'static str, items: impl IntoIterator<Item = String>, cx: &App) -> AnyElement {
     v_flex()
         .gap_2()