Skip to content

Docs: restore reference content lost in writing-migrations split#1073

Merged
LordSimal merged 1 commit into5.xfrom
docs-polish-after-rework
Apr 19, 2026
Merged

Docs: restore reference content lost in writing-migrations split#1073
LordSimal merged 1 commit into5.xfrom
docs-polish-after-rework

Conversation

@dereuromark
Copy link
Copy Markdown
Member

Summary

Follow-up to #1070. While reviewing the split I noticed a few artifacts from the RST-to-Markdown conversion and several reference sections that were dropped or heavily condensed. This restores them without reverting the new page structure.

Fixes

  • bin/cake migration migrate typo in advanced/integration-and-deployment.md
  • Missing space in `phinxlog`tables`phinxlog` tables in the upgrade guide
  • Three leftover <span class="title-ref">...</span> spans replaced with backticks (guides/seeding.md and guides/using-the-query-builder.md)

Restored content

  • Anonymous Migration Classes — brought back the --style anonymous bake workflow and 'style' config key. Added to getting-started/creating-migrations.md since that page owns bake/naming.
  • Table Partitioning — full examples for RANGE / RANGE COLUMNS, LIST / LIST COLUMNS, HASH, KEY (MySQL-only), Literal expressions, and addPartitionToExisting / dropPartition. The previous bullet list referenced the strategies with no usable code.
  • Indexes — MySQL fulltext, MySQL index length, SQL Server/PostgreSQL include columns, partial indexes (setWhere), PostgreSQL setConcurrently, and gin indexes. Also the removeIndex/removeIndexByName example.
  • Foreign keys — composite-key example, the update/delete/constraint/deferrable options table, fluent foreignKey() builder with ForeignKey::CASCADE, and hasForeignKey / dropForeignKey examples.
  • Check constraints — fluent checkConstraint() builder, auto-generated constraint names, complex multi-column expressions, and hasCheckConstraint / dropCheckConstraint examples.

No TOC or page-structure changes — these all land inside the existing pages from #1070.

Follow-up to #1070. The writing-migrations split dropped several
reference sections and left some RST-conversion artifacts.

- Fix `bin/cake migration migrate` typo in integration-and-deployment
- Fix missing space around `phinxlog` tables in upgrade guide
- Replace leftover `<span class="title-ref">...</span>` with backticks
  in seeding and using-the-query-builder
- Restore "Anonymous Migration Classes" section in creating-migrations
- Restore full Table Partitioning examples (RANGE, LIST, HASH, KEY,
  expressions, modifying existing partitions)
- Restore index examples for MySQL fulltext/length, SQL Server and
  PostgreSQL include columns, partial indexes, concurrent indexes,
  and GIN indexes
- Restore foreign key details: composite keys, options table, and
  hasForeignKey/dropForeignKey usage
- Restore check constraint details: fluent builder, auto-generated
  names, complex expressions, has/drop examples
@LordSimal LordSimal merged commit 1fc7f8d into 5.x Apr 19, 2026
6 checks passed
@LordSimal LordSimal deleted the docs-polish-after-rework branch April 19, 2026 08:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants