docs : Update documentation terminology and restructure to LLD format (#64)

[LGSI-KarumuriHari]

📝 PR Description

This PR implements comprehensive documentation updates to standardize terminology and restructure design documents from HLD (High-Level Design) to LLD (Low-Level Design) format, as per documentation review feedback.

Changes Implemented:

1. Terminology Standardization (Commits: d0e552e, e4a9f26, 1374343)

TIMPANI → timpani:

• ✅ Replaced all instances of "TIMPANI" (uppercase) with "timpani" (lowercase) across 24+ documentation files
• ✅ Standardized naming: "Timpani-O" → "timpani-o", "Timpani-N" → "timpani-n"
• ✅ Updated 510+ lines across architecture, API, development guides, and README files
• ✅ Maintained consistency in component naming throughout the project

Phase → Step:

• ✅ Replaced "phases" with "steps" in development and migration roadmaps
• ✅ Updated documentation flow references
• ✅ Standardized terminology across all workflow descriptions

2. Document Structure Migration: HLD → LLD (Commit: b30c574)

Directory Restructure:

• ✅ Renamed doc/architecture/HLD/ → doc/architecture/LLD/
• ✅ Updated 22 component documents (10 timpani-o + 10 timpani-n + 2 READMEs)
• ✅ Changed all document titles from # HLD: → # LLD:
• ✅ Updated document headers: "High-Level Design" → "Low-Level Design"

Component Documentation:

• ✅ timpani-o: 10 LLD documents (SchedInfo, Fault Client, Node Service, Scheduler, etc.)
• ✅ timpani-n: 10 LLD documents (Initialization, Config, Time Trigger, Task Management, etc.)
• ✅ Both README.md files updated with new terminology

3. Cross-Reference Updates (Commit: 1374343)

Navigation Links:

• ✅ Updated doc/README.md: All HLD references → LLD
• ✅ Updated doc/architecture/timpani_architecture.md: 4 references updated
• ✅ Updated doc/docs/structure.md: Repository structure and links updated
• ✅ Updated documentation flow diagrams to reflect LLD structure

Path Updates:

• ✅ All links changed from architecture/HLD/ → architecture/LLD/
• ✅ Component README links verified and updated
• ✅ Documentation flow updated: Architecture → LLD → Implementation

4. File Naming

• ✅ Renamed grpc_architecture.md → timpani_rust_grpc_architecture.md for consistency

Files Changed Summary:

Total: 52 files modified across 4 commits

• Terminology updates: 26 files (510 lines changed)
• Phase → Step: 5 files (41 deletions)
• HLD → LLD: 22 files (166 changes)
• Navigation updates: 4 files (66 changes)

🔗 Related Issue

Closes #64

🧪 Test Method

Terminology Verification

• ✅ Confirmed no "TIMPANI" (uppercase) remains:

  grep -r "TIMPANI" doc/ # No results

• ✅ Verified "Phase" replaced with "Step" where applicable
• ✅ All component names use lowercase format (timpani-o, timpani-n)

Structure Verification

• ✅ Confirmed LLD directory exists: doc/architecture/LLD/
• ✅ Verified subdirectories: timpani-o/ and timpani-n/ present
• ✅ All 20 component files + 2 READMEs present and accessible

Path Reference Verification

• ✅ No HLD path references remain:

  grep -r "architecture/HLD" --include="*.md" doc/ # No results

• ✅ All internal links tested and working
• ✅ Component README links verified
• ✅ Total LLD references: 64 instances across documentation

Rendering Verification

• ✅ All markdown files render correctly in GitHub
• ✅ Mermaid diagrams display correctly with updated terminology
• ✅ Cross-references between documents verified
• ✅ Table of contents links functional in all README files

📸 Screenshots

N/A - Documentation changes only

✅ Checklist

• Code conventions are followed (markdown formatting, SPDX headers preserved)
• Tests are added/modified (N/A for documentation)
• Documentation is updated (this PR IS the documentation update)
• All terminology standardized per review feedback
• Directory structure reflects LLD classification
• All internal links verified and functional
• No broken references remain

⚠️ Breaking Changes

Path Changes:

• All links to /HLD/ paths have been updated to /LLD/
• External references to these documents will need updating if they exist
• Bookmarks to old paths will need to be updated

Mitigation:

• All internal documentation links have been updated
• Clear commit messages document the changes
• README files provide navigation to new structure

📊 Impact

Before:

• Mixed terminology (TIMPANI/timpani, Phase/Step)
• HLD classification (incorrect for detailed design docs)
• Inconsistent component naming

After:

• ✅ Consistent lowercase terminology throughout
• ✅ Correct LLD classification for component-level documents
• ✅ Standardized naming conventions
• ✅ Improved navigation with updated links
• ✅ Better alignment with documentation standards

🔍 Review Focus Areas

1. Terminology Consistency: Verify all instances of TIMPANI replaced correctly
2. Path Accuracy: Check that all LLD path references are correct
3. Link Integrity: Test internal documentation links
4. Document Structure: Confirm LLD classification is appropriate
5. Completeness: Ensure all 64 task checklist items addressed

[LGSI-KarumuriHari]

@basheerFZ please review this pr , Thanks

[basheerFZ]

In this PR we could see LLD updated , renaming of timpani cases