Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Migration Plugin for 1.0 #1393

Closed
zachleat opened this issue Sep 4, 2020 · 3 comments
Closed

Migration Plugin for 1.0 #1393

zachleat opened this issue Sep 4, 2020 · 3 comments
Labels
documentation in-progress
Milestone
Eleventy 1.0.0

Comments

@zachleat
Copy link
Member

zachleat commented Sep 4, 2020

Go through all of the 1.0 issues with breaking changes and make a list of things that need to be updated.

Use console warnings whenever possible to alert users as to old API usage. Use contextual and very informative information about what changed and what changes need to be made in the message.

Prefer (if using a Configuration API method) moderate backwards compatibility to allow the opposite method to still work. e.g. eleventyConfig.setDataDeepMerge(true); is now enabled by default but keep eleventyConfig.setDataDeepMerge(false); for easier upgrading (or even a migration plugin to set these defaults).
@zachleat zachleat added this to the Eleventy 1.0.0 milestone Sep 4, 2020
@zachleat
Copy link
Member Author

zachleat commented Jul 9, 2021

Work has started on some of this here: https://github.com/11ty/eleventy-upgrade-help

@zachleat zachleat changed the title Migration Guide for 1.0 Migration Plugin for 1.0 Jul 10, 2021
@zachleat zachleat mentioned this issue Jul 10, 2021
Closed
@zachleat
Copy link
Member Author

zachleat commented Jul 10, 2021 •
edited
Loading

@zachleat
Copy link
Member Author

zachleat commented Jul 12, 2021 •
edited
Loading

I now consider this complete, although more work may be required here if more defaults change in 1.0.

https://github.com/11ty/eleventy-upgrade-help

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
documentation in-progress
Projects
None yet
Milestone
Eleventy 1.0.0
Development

No branches or pull requests
1 participant
@zachleat