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.

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

Add documentation on upgrading from 0.8 to 0.10 safely #1844

Merged
merged 4 commits into from Aug 9, 2016

Conversation

bkoltai
Copy link
Contributor

@bkoltai bkoltai commented Jul 13, 2016

Purpose

Provide guidance on how to upgrade from 0.8 to 0.10 safely, based on my experience recently upgrading my 0.8.3 app to 0.10.2 successfully.

Changes

Adds docs/howto/upgrade_from_0_8_to_0_10.md

Caveats

The upgrade doc may not contain all edge cases and possible issues during migration. It is purely a documentation of the process that worked for my app.

It maybe be that this is more useful as a gem or some other way with proper testing. Unfortunately, I don't think I'll have time to do this myself, but I wanted to get this out so that someone else could move forward with their migration and contribute a gem that encapsulates the code snippets I provide with proper testing. I hope this document is still useful without this.

Related GitHub issues

#1694
#1005

@mention-bot
Copy link

@bkoltai, thanks for your PR! By analyzing the annotation information on this pull request, we identified @joaomdmoura, @bf4 and @NullVoxPopuli to be potential reviewers

# ` || object.respond_to?(a.first)` to check if the object responded to
# the given method.
def try(*a, &b)
if a.empty? || respond_to?(a.first) || object.respond_to?(a.first)
Copy link
Member

@bf4 bf4 Jul 13, 2016

Choose a reason for hiding this comment

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

probably respond_to?(a.first, true) to include protected methods IIRC

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

@bf4
Copy link
Member

bf4 commented Jul 13, 2016

omg @bkoltai you are super 👍 💯 to so many people 🎉 🌈 🐴 💃

- Add list of breaking changes
- Add `true` param to `responds_to?` calls in overriden `try`
## Disclaimer
### Proceed at your own risk
This document attempts to outline steps to upgrade your app based on the collective experience of
developers who have done this already. It may not cover all edge cases and situation that may cause issues,
Copy link
Member

Choose a reason for hiding this comment

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

typo: situations

@bkoltai bkoltai force-pushed the bk_upgrade_0_8_to_0_10_doc branch from f98cac5 to d9ba5cd Compare July 21, 2016 04:07
@bf4 bf4 merged commit 9217bc2 into rails-api:master Aug 9, 2016
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.

None yet

3 participants