Skip to content

docs: list configuration changes in the 1.x to 2.x migration guide - #3513

Draft
pjfanning wants to merge 1 commit into
apache:mainfrom
pjfanning:migration-guide-2x-config-changes
Draft

docs: list configuration changes in the 1.x to 2.x migration guide#3513
pjfanning wants to merge 1 commit into
apache:mainfrom
pjfanning:migration-guide-2x-config-changes

Conversation

@pjfanning

Copy link
Copy Markdown
Member

Motivation

The 1.x to 2.x migration guide did not mention the reference.conf changes between the 1.7.x and main branches, so users had no single place to review new settings and changed defaults when upgrading.

Modification

Add a "Configuration Changes in Pekko 2.x" section to migration-guide-1.x-2.x.md, based on diffing all src/main/resources/reference.conf files between the 1.7.x and main branches. It covers:

  • changed default values (e.g. minimum-runnable, propagate-harmless-quarantine-events, tcp-magic, the Artery frequency sketch, persistence plugin dispatchers)
  • removed settings
  • new settings, grouped by module, with @ref links to the default configuration reference and links to the PRs that introduced each setting

Result

Users migrating from Pekko 1.x to 2.x can review the configuration changes in one place.

Tests

  • Not run - docs only

References

None - sourced from diffing the reference.conf files between the 1.7.x and main branches

Motivation:
The 1.x to 2.x migration guide did not mention the reference.conf
changes between the 1.7.x and main branches, so users had no single
place to review new settings and changed defaults.

Modification:
Add a Configuration Changes section to migration-guide-1.x-2.x.md
covering changed default values, removed settings and new settings,
grouped by module, with links to the originating PRs and to the
default configuration reference.

Result:
Users migrating from Pekko 1.x to 2.x can review the configuration
changes in one place.

Tests:
- Not run - docs only

References:
None - sourced from diffing reference.conf files between 1.7.x and main
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