[TheLinuxGuy]

What changed and why

The optional iCloud bridge was difficult to discover without a clear view of the phone experience. The README now showcases the real Obsidian iPhone dashboard and links directly to setup and an illustrated task round trip, while keeping Folderwise's Markdown-and-Git identity clear.

Add five small visual assets: a branded dashboard composition, an SVG workflow diagram, separately labelled completion/reopening captures, a returned task-rename example, and the actual Mac attention banner. Expand the Obsidian guide, command guide, acceptance-testing guidance and asset provenance to explain opt-ins, source authority, validation, scheduling delays and local-only commits. Keep the existing hero/logo and desktop example.

This PR is stacked on #14 (feat/ibridge-note-edits) because the documentation describes that implementation. The diff contains documentation and assets only; no bridge behavior or knowledge repositories were changed.

Screenshots use fictional acceptance-test data. The task sequence shows two distinct CSV demo tasks and distinguishes phone state before sync from returned source views. Screenshots do not independently establish Git commits or selected-note editing. Original captures and permissions were preserved; all crops and generated components are recorded in docs/assets/PROVENANCE.md.

Validation

• uv run _tools/selftest.py: 630/630 checks passed before and after the work (temporary UV_CACHE_DIR).
• uv run .github/scripts/test_public_docs.py: 244/244 checks passed.
• No behavior changes; README and detailed guides describe the existing implementation.
• Only fictional examples; no real documents, identifiers, credentials, or machine-specific source paths added.
• python3 _tools/framework_guard.py passes after staging; all new assets also pass the guard's path validation and are not ignored.
• Relative links, anchors, image paths, alt text and git diff --check pass.
• Rendered all edited Markdown at 1100px and 390px with no broken images or page overflow; inspected final images at intended display sizes.
• Verified all 15 original capture hashes and permissions; checked screenshot regions against source pixels.

Previews use a local GitHub-style renderer. No new real-device acceptance run was performed, and no bridge setup/sync was run against real projects.

Needs careful review (check if touched)

• Workflows, .github/scripts/, .coveragerc, codecov.yml, ruff.toml
• .gitignore allowlist or _tools/framework_guard.py
• Coverage thresholds or exclusions

None of these policy/configuration files changed.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.46%. Comparing base (9400eca) to head (5a22a41).
⚠️ Report is 2 commits behind head on feat/ibridge-note-edits.

Additional details and impacted files

@@                   Coverage Diff                    @@
##           feat/ibridge-note-edits      #15   +/-   ##
========================================================
  Coverage                    92.46%   92.46%           
========================================================
  Files                           16       16           
  Lines                         3252     3252           
========================================================
  Hits                          3007     3007           
  Misses                         245      245           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.