Function collect_comments 

fn collect_comments(
    docs: &DocComments<'_>,
    name_to_page: &NameToPage,
    page_path: &Path,
) -> CommentData

Collect natspec from doc comments, applying inline link replacement.

Solar emits each /// line as a separate DocComment. Lines without a @ tag become synthetic @notice items with leading whitespace in their raw content. We detect these continuation lines and join them to the previous description paragraph so that multi-line natspec tags appear as a single coherent block in the right source order.