refactor(kernel): split ipc/memory/lib/thread by concern; trim comments

crates/types/src/badge.rs

@@ -1,6 +1,4 @@
-/// A word stamped on an endpoint or notification capability by `Mint`.
-/// Receivers see the badge of the capability a sender used, which is how a
-/// server tells its clients apart. Zero means "unbadged".
+/// A word stamped on an endpoint or notification cap by `Mint`; zero means unbadged.
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
 pub struct Badge(usize);
 

crates/types/src/bootinfo.rs

@@ -1,7 +1,4 @@
-//! What boot tells init: a read-only page at `BOOT_INFO_VA` saying which
-//! of init's capability slots hold which board device (seL4's BootInfo,
-//! reduced to what this system needs). Everything else init learns by
-//! asking the devices themselves.
+//! What boot tells init: a read-only page at `BOOT_INFO_VA` mapping init's capability slots to board devices.
 
 /// Where the page is mapped in init.
 pub const BOOT_INFO_VA: usize = 0x2F000;
@@ -11,9 +8,7 @@ pub const MAX_BOOT_DEVICES: usize = 16;
 /// A slot field with no capability in it.
 pub const NO_SLOT: u64 = u64::MAX;
 
-/// What kind of device a board entry is. Board code knows; init asks the
-/// device itself only where a kind has several possibilities (which
-/// virtio device sits in a slot).
+/// What kind of device a board entry is; init asks the device itself to disambiguate.
 pub const KIND_VIRTIO: u64 = 1;
 pub const KIND_UART_16550: u64 = 2;
 

crates/types/src/proofs/generation.rs

@@ -1,8 +1,6 @@
 use crate::generation::Generation;
 
-/// Generations only ever increase, so a capability minted for an earlier
-/// generation can never match again. (The old wrapping counter returned to
-/// earlier values after 2^32 bumps.)
+/// Generations only increase, so a capability minted for an earlier generation never matches again.
 #[kani::proof]
 fn generation_next_is_strictly_greater_or_exhausted() {
     let value: u32 = kani::any();