Auto-generated consolidated documentation for Point-Free's Swift libraries. This repository exists because AI coding assistants struggle with Point-Free's DocC format, so we flatten everything into simple Markdown files.
When working with Point-Free libraries (Composable Architecture, Swift Navigation, etc), AI assistants often can't parse the official DocC documentation. This repository solves that by:
- Cloning each Point-Free repository
- Extracting all
.mdfiles from their documentation folders - Consolidating them into single files per library
| Library | Consolidated File | Original Repository |
|---|---|---|
| Swift Composable Architecture | swift-composable-architecture-docs.md | pointfreeco/swift-composable-architecture |
| Swift Navigation | swift-navigation-docs.md | pointfreeco/swift-navigation |
| Swift Dependencies | swift-dependencies-docs.md | pointfreeco/swift-dependencies |
| Swift Case Paths | swift-case-paths-docs.md | pointfreeco/swift-case-paths |
| SQLiteData | sqlite-data-docs.md | pointfreeco/sqlite-data |
Simply provide your AI assistant with the raw GitHub URL of the documentation you need:
https://raw.githubusercontent.com/juavazmor/pointfree-docs-consolidated/main/swift-composable-architecture-docs.md
Replace juavazmor with your username if you forked this repository.
A GitHub Actions workflow runs and:
- Clones each Point-Free repository
- Finds all
.mdfiles in their documentation folders - Concatenates them with proper headers and structure
- Commits the updated consolidated files
See .github/workflows/sync-pointfree-docs.yml for the complete implementation.
You can trigger updates manually from the Actions tab, or run the local script if you want to test changes locally.
If Point-Free adds new libraries or changes their documentation structure, simply update the repository list in the workflow file. The script is flexible and handles multiple documentation folders per repository.
Currently tracking documentation for:
- Composable Architecture - State management and architecture
- Swift Navigation - Declarative navigation tools
- Swift Dependencies - Dependency management
- Swift Case Paths - Key path utilities for enums
- SQLiteData - A fast, lightweight replacement for SwiftData
Generated documentation files are automatically updated and may overwrite manual changes.