Skip to content

docs: comprehensive documentation update and GitHub Actions improvements#2

Merged
simllll merged 7 commits intomasterfrom
claude/docs-and-github-actions-J17y4
Jan 21, 2026
Merged

docs: comprehensive documentation update and GitHub Actions improvements#2
simllll merged 7 commits intomasterfrom
claude/docs-and-github-actions-J17y4

Conversation

@simllll
Copy link
Owner

@simllll simllll commented Jan 21, 2026

Summary

  • Comprehensive documentation rewrite for all packages with interface definitions, examples, and usage guides
  • Modern GitHub Actions CI/CD with auto-versioning via conventional commits
  • Removed deprecated Travis CI configuration

Documentation Updates

Main README (root)

  • Added badges (npm, license, Node.js, TypeScript)
  • Architecture diagram showing decorator/strategy/storage layers
  • Package table with all storage adapters
  • Storage comparison table for choosing the right backend

ts-cache README (main package)

  • Complete API documentation with table of contents
  • Detailed decorator docs (@Cache, @SyncCache, @MultiCache)
  • Interface definitions for all storage and key strategy types
  • Strategy options (TTL, lazy vs eager expiration)
  • Custom key strategies (sync and async)
  • Advanced usage patterns (call deduplication, error handling)

Storage Adapter READMEs

All 5 storage adapters now have comprehensive docs with installation, examples, options, and interface definitions.

Code Changes

  • Added IAsyncKeyStrategy to public exports

CI/CD Updates

  • test.yml: Updated to actions v4, tests on Node 18/20/22
  • publish.yml: Manual release workflow with auto-versioning via conventional commits

Cleanup

  • Removed deprecated .travis.yml

- Update main README with architecture overview, features, and package table
- Rewrite ts-cache README with complete API documentation:
  - Interface definitions (IAsynchronousCacheType, ISynchronousCacheType, etc.)
  - Detailed decorator usage (@Cache, @SyncCache, @MultiCache)
  - Strategy options and examples
  - Custom key strategies (sync and async)
  - Advanced usage patterns (deduplication, error handling)
- Update all storage adapter READMEs with:
  - Installation instructions
  - Usage examples (basic, with options, multi-operations)
  - Constructor options and interface definitions
  - TTL behavior documentation
- Add IAsyncKeyStrategy to public exports
- Modernize CI/CD:
  - Update test.yml to use actions v4, test on Node 18/20/22
  - Add publish.yml for automated npm publishing with:
    - Release-triggered publishing
    - Manual workflow dispatch with version type selection
    - Auto-versioning via conventional commits
    - Dry-run support
- Remove deprecated .travis.yml
- Remove automatic release triggers (push to master, release events)
- Keep only manual workflow_dispatch trigger
- Add comprehensive release notes generation:
  - Lists all published packages with versions
  - Includes commits since last release
  - Adds installation instructions
- Create GitHub release with gh CLI after npm publish
- Add dry-run mode for previewing changes
- Add workflow summary for release results
- Support prerelease versions with custom identifiers
- Add version_type input with 'auto' as default
- Auto mode uses conventional commits to determine version:
  - fix: → patch
  - feat: → minor
  - BREAKING CHANGE → major
- Manual override still available (patch/minor/major)
- Simplified workflow with only dry_run and version_type inputs
- Add lint script to run ESLint on all source files
- Add format script to check Prettier formatting
- Update CI workflow to run lint and format checks on PRs
- Format check is non-blocking (continue-on-error) due to existing code style
- Format all TypeScript, JavaScript, JSON, and Markdown files
- Make Prettier check blocking in CI (no longer continue-on-error)
- Remove debug console.log from RedisStorage constructor
- Fix no-promise-executor-return in FsJsonStorage (use block syntax)
- Apply auto-fixable lint fixes to multicache.decorator
- Remove Node 18 (EOL April 2024)
- Add Node 24 (latest release April 2025)
- Keep Node 20 and 22 (current LTS versions)
@simllll simllll merged commit 01d0a3d into master Jan 21, 2026
5 checks passed
@simllll simllll deleted the claude/docs-and-github-actions-J17y4 branch January 22, 2026 14:47
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.

2 participants