Skip to content

v0.6.4-release-qa.md

Latest commit

 

History

History
98 lines (72 loc) · 4.06 KB

v0.6.4-release-qa.md

File metadata and controls

98 lines (72 loc) · 4.06 KB
Raw

v0.6.4 Release QA Checklist

Milestone: 0.6.4

This checklist covers the v0.6.4 quality release issues: #89, #90, #91, #92, and #93.

Required Build Verification

scripts/ci/build_platform_matrix.sh

Expected result:

  • macOS Debug build succeeds with CODE_SIGNING_ALLOWED=NO.
  • iOS Simulator Debug build succeeds with CODE_SIGNING_ALLOWED=NO.
  • iPad Simulator Debug build succeeds with TARGETED_DEVICE_FAMILY=2.
  • .DerivedDataMatrix is removed by the script on exit.

Markdown PDF Export Regression

Fixture: samples/markdown-fixtures/pdf-export-long-regression.md

  • Open the fixture on macOS, iPhone, and iPad.
  • Export with Paginated Fit.
  • Confirm the PDF has more than two pages.
  • Confirm the first, middle, and final sections are present.
  • Confirm the final marker is visible: FINAL MARKER: v0.6.4 Markdown PDF export coverage reached the end.
  • Export with One Page Fit.
  • Confirm the PDF has one flexible-height page.
  • Confirm the page uses tight margins and does not clip the final marker.
  • Confirm tables, checklists, block quotes, links, and fenced code remain legible.

Automated coverage:

  • MarkdownPreviewPDFRendererTests.testPaginatedSourceRangesCoverLongMarkdownWithoutGaps
  • MarkdownPreviewPDFRendererTests.testPaginatedSourceRangesIgnoreInvalidBlockMeasurements

Mobile Toolbar and Sidebar Parity

Reference matrix: release/v0.6.4-mobile-parity-matrix.md

  • iPhone: Tap project sidebar Open File, Open Folder, New File, New Folder, and Help.
  • iPhone: Verify each action presents the expected dialog or sheet and is not silent.
  • iPhone: Create a new file from the sidebar and confirm a new tab is opened.
  • iPhone: Verify Code Snapshot defaults to wrap mode.
  • iPhone: Verify diff header text remains compact enough to avoid excessive wrapping.
  • iPad: Verify Toolbar Help is visible in the toolbar, not only in the 3-dot menu.
  • iPad: Verify Markdown preview text size is readable in portrait and landscape.
  • iPad with keyboard: Verify tab/focus order through toolbar, sidebar, editor, preview, and dialogs.

README and Release Documentation

  • README.md keeps a blank line before ## Project Documentation.
  • Project Documentation links include release QA and mobile parity documents.
  • Roadmap points Next to v0.6.4 quality work, not stale v0.6.3 diff items.
  • The v0.6.4 milestone link points to milestone 16.
  • The What's New Since v0.6.2 section still reflects v0.6.3 release changes.
  • App Store/TestFlight copy remains in release/v0.6.3-store-copy.md until a v0.6.4 release copy file is created.

Download Metrics and Workflow

  • Run the metrics script in check mode before release docs are finalized:
python3 scripts/update_download_metrics.py --check
  • Inspect the latest metrics workflow if README download badges look stale:
gh run list --limit 5
  • If the workflow reports invalid v0.6.3 downloads, inspect the run logs before updating README metrics.

Accessibility

  • VoiceOver reads every toolbar and sidebar action by purpose, not just by icon.
  • Disabled toolbar actions expose disabled state.
  • Dialog focus starts in the primary input field.
  • Dismissing a dialog returns focus to the invoking toolbar or sidebar action.
  • No compact toolbar, help sheet, diff header, or preview state traps VoiceOver focus.
  • iPad hardware keyboard focus order remains predictable across toolbar, sidebar, editor, preview, and dialogs.

Exit Criteria

  • Cross-platform build matrix passes.
  • PDF export fixture reaches the final marker in both export modes.
  • Mobile parity matrix passes on iPhone and iPad.
  • README roadmap and Project Documentation render correctly on GitHub.
  • Release notes mention any remaining manual QA limitations before tagging v0.6.4.