Skip to content

feat: Consolidate screenshot generation into main repo and CI workflow#49

Merged
wesm merged 3 commits intomainfrom
consolidate-screenshots
Nov 15, 2025
Merged

feat: Consolidate screenshot generation into main repo and CI workflow#49
wesm merged 3 commits intomainfrom
consolidate-screenshots

Conversation

@wesm
Copy link
Owner

@wesm wesm commented Nov 15, 2025

Eliminate moneyflow-assets repository dependency by integrating screenshot generation directly into the GitHub Actions docs deployment workflow.

Changes

Infrastructure

  • Update generate_screenshots.py to output to docs/assets/screenshots/
  • Add screenshot generation step to docs.yml workflow (runs on stable push)
  • Add screenshot verification to bump-version.sh pre-release checks
  • Simplify post-publish.sh by removing moneyflow-assets logic (-80 lines)
  • Add docs/assets/screenshots/ to .gitignore (generated fresh in CI)

Documentation

  • Update README.md screenshot URL to moneyflow.dev (deployed site)
  • Update all docs/*.md files to use relative paths (28 references across 5 files)
  • Update PUBLISHING.md and scripts/README.md to reflect new workflow

Benefits

  • Simpler workflow (one repo instead of two)
  • Automated screenshot generation (no manual steps)
  • Atomic deployments (screenshots and docs always in sync)
  • Verifiable releases (screenshot generation tested before version bump)
  • Cleaner codebase (-80 lines of bash script)

Testing

  • Screenshot generation verified locally
  • All code quality checks passing (ruff, pyright, markdownlint)
  • Ready for CI testing on stable branch

See MIGRATION_SUMMARY.md for complete migration details.

🤖 Generated with Claude Code

wesm and others added 3 commits November 15, 2025 15:58
Eliminate moneyflow-assets repository dependency by integrating screenshot
generation directly into the GitHub Actions docs deployment workflow.

## Changes

### Infrastructure
- Update generate_screenshots.py to output to docs/assets/screenshots/
- Add screenshot generation step to docs.yml workflow (runs on stable push)
- Add screenshot verification to bump-version.sh pre-release checks
- Simplify post-publish.sh by removing moneyflow-assets logic (-80 lines)
- Add docs/assets/screenshots/ to .gitignore (generated fresh in CI)

### Documentation
- Update README.md screenshot URL to moneyflow.dev (deployed site)
- Update all docs/*.md files to use relative paths (28 references across 5 files)
- Update PUBLISHING.md and scripts/README.md to reflect new workflow

## Benefits
- Simpler workflow (one repo instead of two)
- Automated screenshot generation (no manual steps)
- Atomic deployments (screenshots and docs always in sync)
- Verifiable releases (screenshot generation tested before version bump)
- Cleaner codebase (-80 lines of bash script)

## Testing
- Screenshot generation verified locally
- All code quality checks passing (ruff, pyright, markdownlint)
- Ready for CI testing on stable branch

See MIGRATION_SUMMARY.md for complete migration details.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
The docs-build-check workflow (runs on main/PRs) needs to generate
screenshots before building docs, otherwise mkdocs build fails because
docs reference screenshots that don't exist.

This mirrors the same screenshot generation step from the docs deployment
workflow (docs.yml).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Files in docs/guide/ need to use ../assets/screenshots/ to reference
screenshots in docs/assets/screenshots/, not assets/screenshots/.

Also fixed broken anchor link in filters.md to match actual heading
in navigation.md.

This resolves mkdocs --strict build failures.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@wesm wesm merged commit 229a296 into main Nov 15, 2025
9 checks passed
@wesm wesm deleted the consolidate-screenshots branch November 15, 2025 22:09
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.

1 participant