Skip to content

docs: simplify v2 upgrade instructions - #307

Merged
andrey-helldar merged 2 commits into
mainfrom
docs/2x-upgrade-guide
Oct 14, 2026
Merged

andrey-helldar merged 2 commits into
mainfrom
docs/2x-upgrade-guide

Conversation

@andrey-helldar

@andrey-helldar andrey-helldar commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

What:

  • Bug Fix
  • New Feature

Description:

Replace manual migration copying in the v2 upgrade guide with php artisan vendor:publish --tag=feeds-migrations. Explain that the command publishes all migration files and that developers must validate them and delete unnecessary files before running migrations. Require the new slug migration's filename timestamp to follow the application's actual create-table migration and precede every feed-registration migration, so migrate:fresh adds the slug column before registrations write to it.

Use products consistently in generation and scheduling examples, with the matching Products registration title. Update all eight translations, search indexes, and llms.txt.

Validation: localization, metadata, snippets, TypeScript, and git diff --check passed. The registration failure before the slug migration and success after it were reproduced with SQLite in memory. Full documentation build was blocked locally by SWC native binding cache permissions.

@andrey-helldar andrey-helldar added the fix Functionality or something fix label Oct 14, 2026 — with ChatGPT Codex Connector
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-14T15:14:03.379627Z 768f6a4 New commits
🔒 Security Review ✅ Completed 2026-10-14T15:04:37.235015Z 03cbf82 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 03cbf820f1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

2. Set its filename timestamp immediately after the application's actual `create_feeds_table` migration and before any feed-registration migrations. Keep the `add_slug_to_feeds_table` suffix. This order also lets a fresh database create registrations after the slug column exists.
3. Confirm that `feeds.table.connection` and `feeds.table.table` point to the existing registration table, then run migrations:
```bash
php artisan vendor:publish --tag=feeds-migrations

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Publish only the ordered slug migration

For applications upgrading from 1.x with the original table migration and generated feed-registration migrations, this command publishes both package migrations because LaravelFeedServiceProvider::migrations() maps the entire directory. Laravel 13 then replaces their timestamps with the publication time: unless the user identifies and removes the new create-table copy, migrate tries to create the existing table, and even after removing it the slug migration sorts after older registration migrations, so migrate:fresh runs registrations that write slug before that column exists. Restore the selective slug-file copy and explicitly place its timestamp after create_feeds_table but before feed-registration migrations.

Useful? React with 👍 / 👎.

@andrey-helldar
andrey-helldar merged commit 9e8df0e into main Oct 14, 2026
19 checks passed
@andrey-helldar
andrey-helldar deleted the docs/2x-upgrade-guide branch October 14, 2026 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fix Functionality or something fix

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant