DRDataRaft/ docs
GitHub ↗

Review a proposed YAML change

Inspect the actual proposed diff before changing the document.

Positron and VS Code

Command or action
Preview field edits → review diff → apply or discard

The native diff viewer compares the proposed contract change with the current document.
The native diff viewer compares the proposed contract change with the current document. Open full-resolution screenshot ↗
The editor offers explicit Apply preview to document and Discard preview controls.
The editor offers explicit Apply preview to document and Discard preview controls. Open full-resolution screenshot ↗

What this does

Preview creates a proposed edit and opens the native diff viewer. The document itself remains unchanged until you explicitly apply the preview.

Try it

  1. Change a contract field.
  2. Select Preview field edits.
  3. Inspect the proposed diff, including any formatting or metadata changes.
  4. Return to the contract editor and choose Apply preview to document or Discard preview.

Read the screenshots

The diff proposes changing the synthetic contract name to Applied form change. The separate preview screenshot shows the discard decision from another edit. The acceptance test verifies that preview alone leaves both the document and the saved file unchanged.

Keep in mind

The proposal is tied to a specific document version. A concurrent text edit invalidates it. Review the current state and create a new preview instead of applying a stale proposal.

Original capture from the native Positron extension host, using synthetic data. Extension implementation: 0d55d40. Screenshot automation: 0d55d40. Successful native capture run ↗

Search documentation

Search functions, packages and guides.