Skip to content

doc(versions): add requirements table, EOL notice and upgrade guide#16

Merged
jfrosorio merged 2 commits into
v1from
doc-15
Jul 14, 2026
Merged

doc(versions): add requirements table, EOL notice and upgrade guide#16
jfrosorio merged 2 commits into
v1from
doc-15

Conversation

@jfrosorio

@jfrosorio jfrosorio commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Description

Makes the version landscape visible to users landing on the v1 branch:

  • README: EOL warning banner (with a pointer to the 2.1.0 redaction security fix), requirements/versions table linking the v2 and main branches
  • New UPGRADE.md: 1.x → 2.0 guide (user_id FK → polymorphic causer migration steps, HasApiLogs trait) plus a pointer to the 2.x → 3.0 guide

Docs only — no code changes, no release needed.

Fixes

Part of #15 (v1 docs) — see #17 for the main part. Note: this PR targets the v1 branch, so the closing keyword would not act; #15 is closed by #17.

@jfrosorio jfrosorio self-assigned this Jul 14, 2026
@jfrosorio jfrosorio added the documentation Improvements or additions to documentation label Jul 14, 2026
@jfrosorio
jfrosorio requested a review from Copilot July 14, 2026 15:01

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves discoverability and upgrade guidance for users landing on the legacy v1 branch by adding an EOL notice, a version/requirements overview, and a dedicated upgrade guide to newer major versions.

Changes:

  • Added UPGRADE.md documenting the 1.x → 2.0 upgrade path and linking to the 2.x → 3.0 guide.
  • Added an EOL warning banner to the v1 README with a pointer to the upgrade guide and security-fix context.
  • Added a requirements/version table to the v1 README linking to the v2 and main branches.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
UPGRADE.md Adds upgrade instructions for moving from 1.x to 2.0 and links onward to 3.0 guidance.
README.md Adds EOL warning and a version/requirements table to make supported versions discoverable on v1.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread UPGRADE.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants