Removes module-level doc comments (//! lines) and excessive inline doc comments that were duplicating information already evident from: - Function/struct names (self-documenting code) - Type signatures (the what is clear from types) - Implementation context (the how is clear from code) Affected modules: - cli/* - Removed command descriptions duplicating clap help text - core/* - Removed module headers and obvious function docs - documents/* - Removed extractor/regenerator/truncation docs - embedding/* - Removed pipeline and chunking docs - gitlab/* - Removed client and transformer docs (kept type definitions) - ingestion/* - Removed orchestrator and ingestion docs - search/* - Removed FTS and vector search docs Philosophy: Code should be self-documenting. Comments should explain "why" (business decisions, non-obvious constraints) not "what" (which the code itself shows). This change reduces noise and maintenance burden while keeping the codebase just as understandable. Retains comments for: - Non-obvious business logic - Important safety invariants - Complex algorithm explanations - Public API boundaries where generated docs matter Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
14 lines
475 B
Rust
14 lines
475 B
Rust
mod extractor;
|
|
mod regenerator;
|
|
mod truncation;
|
|
|
|
pub use extractor::{
|
|
DocumentData, SourceType, compute_content_hash, compute_list_hash, extract_discussion_document,
|
|
extract_issue_document, extract_mr_document,
|
|
};
|
|
pub use regenerator::{RegenerateResult, regenerate_dirty_documents};
|
|
pub use truncation::{
|
|
MAX_DISCUSSION_BYTES, MAX_DOCUMENT_BYTES_HARD, NoteContent, TruncationReason, TruncationResult,
|
|
truncate_discussion, truncate_hard_cap, truncate_utf8,
|
|
};
|