Skip to content

WIP: trim deliberate-trade-off prose from RWM page (depends on #184 + #185)#186

Draft
dimitri-yatsenko wants to merge 1 commit into
mainfrom
wip/trim-rwm-deliberate-tradeoff
Draft

WIP: trim deliberate-trade-off prose from RWM page (depends on #184 + #185)#186
dimitri-yatsenko wants to merge 1 commit into
mainfrom
wip/trim-rwm-deliberate-tradeoff

Conversation

@dimitri-yatsenko

Copy link
Copy Markdown
Member

Draft / WIP. This PR is a tracker only — no docs changes yet.

Goal

After #184 (expanded RWM intro) and #185 (new deeper concept pages) land, the "deliberate trade-off" argument will live in two places:

This PR will trim the RWM-page version down to a one-paragraph mention + pointer, so the developed argument lives only in the Comparison page.

Status

The branch currently contains only .github/follow-ups/trim-rwm-deliberate-tradeoff.md — a tracker file with the outline. The actual trim is not yet applied and depends on:

Once both land, the steps are:

  1. Rebase this branch onto main
  2. Edit src/explanation/relational-workflow-model.md: replace the "deliberate trade-off" section with a tight paragraph + link to comparison-to-workflow-languages.md
  3. Delete the tracker file
  4. Build the docs locally to verify the surrounding flow still reads cleanly
  5. Move PR out of draft, request review

Outline lives in .github/follow-ups/trim-rwm-deliberate-tradeoff.md.

Placeholder for follow-up work after #184 (expand RWM) and #185 (deeper
concept pages) merge. Tracker file outlines what to trim, why, and how to
pick the work up once both upstream PRs land.

No content changes to docs source in this PR. The tracker file is to be
deleted in the same commit that applies the trim.
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