Skip to content

docs: fix broken links and add missing documentation#283

Merged
kcenon merged 4 commits into
mainfrom
fix/282-documentation-broken-links
Dec 10, 2025
Merged

docs: fix broken links and add missing documentation#283
kcenon merged 4 commits into
mainfrom
fix/282-documentation-broken-links

Conversation

@kcenon

@kcenon kcenon commented Dec 10, 2025

Copy link
Copy Markdown
Owner

Summary

  • Fix 5 broken documentation links in README.md
  • Create missing docs/guides/QUICK_START.md for 5-minute getting started
  • Create docs/guides/TROUBLESHOOTING.md for common issues and solutions
  • Add C++20 Concepts documentation for recent feature additions
  • Update Korean README with corrected links and new documentation structure

Changes

Fixed Links (README.md)

Line Before After
215 docs/guides/USER_GUIDE.md docs/advanced/USER_GUIDE.md
220 docs/guides/API_REFERENCE.md docs/advanced/02-API_REFERENCE.md
206, 221 docs/advanced/ARCHITECTURE.md docs/advanced/01-ARCHITECTURE.md
235 docs/guides/MIGRATION_GUIDE.md docs/advanced/MIGRATION.md

New Documentation

  • QUICK_START.md/QUICK_START_KO.md: Prerequisites, installation, first thread pool example, CMake integration
  • TROUBLESHOOTING.md/TROUBLESHOOTING_KO.md: Build issues, runtime issues, performance issues, platform-specific issues
  • CPP20_CONCEPTS.md/CPP20_CONCEPTS_KO.md: Documents C++20 concepts integration (commits dbc3363, e182091, 9122fa3)

README_KO.md Updates

  • Restructured documentation section to match English README format
  • Updated all documentation links to correct paths
  • Added links to new Korean documentation files

Test plan

  • Verify all documentation links work correctly
  • Review new documentation for accuracy
  • Check Korean translations are consistent

Closes #282

Create QUICK_START.md and QUICK_START_KO.md with:
- Prerequisites and installation steps
- First thread pool example with CMake integration
- Key concepts: thread pool, workers, jobs
- Common patterns: parallel processing, error handling
- Links to related documentation

Closes partially #282
Create TROUBLESHOOTING.md and TROUBLESHOOTING_KO.md covering:
- Build issues: C++20, vcpkg, compiler, linker errors
- Runtime issues: thread pool startup, deadlock, memory leaks
- Performance issues: throughput, CPU usage, lock contention
- Platform-specific issues: macOS, Windows, Linux

Closes partially #282
Create CPP20_CONCEPTS.md and CPP20_CONCEPTS_KO.md documenting:
- Available concepts: Callable, VoidCallable, JobType, PoolJob, etc.
- Usage examples with code samples
- Type traits: is_duration, is_future_like, callable_return_type
- Compiler requirements for C++20 concepts
- C++17 fallback behavior
- Integration with common_system

This documents recent C++20 concepts integration (commits dbc3363,
e182091, 9122fa3) which previously lacked documentation.

Closes partially #282
Fix 5 broken links in README.md:
- docs/guides/USER_GUIDE.md -> docs/advanced/USER_GUIDE.md
- docs/guides/API_REFERENCE.md -> docs/advanced/02-API_REFERENCE.md
- docs/advanced/ARCHITECTURE.md -> docs/advanced/01-ARCHITECTURE.md
- docs/guides/MIGRATION_GUIDE.md -> docs/advanced/MIGRATION.md
- Add link to new C++20 Concepts documentation

Update README_KO.md documentation section:
- Add structured documentation sections matching English README
- Update all documentation links to correct paths
- Add links to new QUICK_START_KO and TROUBLESHOOTING_KO guides

Closes #282
@github-actions

Copy link
Copy Markdown
Contributor

📊 Performance Benchmark Results

Performance Benchmark Report

No benchmark data available.

ℹ️ No baseline reference available

This is the first benchmark run or baseline file is missing.

@kcenon kcenon merged commit b2532f1 into main Dec 10, 2025
25 checks passed
@kcenon kcenon deleted the fix/282-documentation-broken-links branch December 10, 2025 04:09
kcenon added a commit that referenced this pull request Apr 13, 2026
* docs(guides): add Quick Start guide for 5-minute setup

Create QUICK_START.md and QUICK_START_KO.md with:
- Prerequisites and installation steps
- First thread pool example with CMake integration
- Key concepts: thread pool, workers, jobs
- Common patterns: parallel processing, error handling
- Links to related documentation

Closes partially #282

* docs(guides): add Troubleshooting guide for common issues

Create TROUBLESHOOTING.md and TROUBLESHOOTING_KO.md covering:
- Build issues: C++20, vcpkg, compiler, linker errors
- Runtime issues: thread pool startup, deadlock, memory leaks
- Performance issues: throughput, CPU usage, lock contention
- Platform-specific issues: macOS, Windows, Linux

Closes partially #282

* docs(advanced): add C++20 Concepts documentation

Create CPP20_CONCEPTS.md and CPP20_CONCEPTS_KO.md documenting:
- Available concepts: Callable, VoidCallable, JobType, PoolJob, etc.
- Usage examples with code samples
- Type traits: is_duration, is_future_like, callable_return_type
- Compiler requirements for C++20 concepts
- C++17 fallback behavior
- Integration with common_system

This documents recent C++20 concepts integration (commits dbc3363,
e182091, 9122fa3) which previously lacked documentation.

Closes partially #282

* docs: fix broken links and update documentation structure

Fix 5 broken links in README.md:
- docs/guides/USER_GUIDE.md -> docs/advanced/USER_GUIDE.md
- docs/guides/API_REFERENCE.md -> docs/advanced/02-API_REFERENCE.md
- docs/advanced/ARCHITECTURE.md -> docs/advanced/01-ARCHITECTURE.md
- docs/guides/MIGRATION_GUIDE.md -> docs/advanced/MIGRATION.md
- Add link to new C++20 Concepts documentation

Update README_KO.md documentation section:
- Add structured documentation sections matching English README
- Update all documentation links to correct paths
- Add links to new QUICK_START_KO and TROUBLESHOOTING_KO guides

Closes #282
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation: Fix broken links and update documentation structure in README.md

1 participant