Skip to content

Reorder README: lead with Use Cases, demote 1.x migration - #23

Merged
MartinsMednis merged 1 commit into
mainfrom
readme-reorder
Sep 14, 2026
Merged

MartinsMednis merged 1 commit into
mainfrom
readme-reorder

Conversation

@MartinsMednis

Copy link
Copy Markdown
Collaborator

Pure reorder, no content lost - headings unchanged so all anchor links remain valid.

  • Move Use Cases up to right after the pitch, before Installation - it's the section that answers "why would I want this," not reference material to reach after several other sections
  • Move Migrating from 1.x down, after Error Handling - relevant to a shrinking minority of readers, was previously the 3rd section
  • Fold the top-of-file "Heads up" breaking-change banner into the Migrating from 1.x section itself; replace it with a one-line pointer for readers coming from 1.x
  • Reorder the Table of Contents and Supported Operations/Restricting Available Functions to match

- Move Use Cases up to right after the pitch, before Installation -
  it's the section that answers "why would I want this," not
  reference material to reach after several other sections
- Move Migrating from 1.x down, after Error Handling - relevant to
  a shrinking minority of readers, was previously the 3rd section
- Fold the top-of-file "Heads up" breaking-change banner into the
  Migrating from 1.x section itself; replace it with a one-line
  pointer for readers coming from 1.x
- Reorder the Table of Contents and Supported Operations/
  Restricting Available Functions to match
@MartinsMednis
MartinsMednis merged commit 462c0ec into main Sep 14, 2026
2 checks passed
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