Skip to content

docs: Make UPGRADING examples more copyable#1363

Merged
iMacTia merged 2 commits intomainfrom
docs-20-upgrading-examples
Jan 5, 2022
Merged

docs: Make UPGRADING examples more copyable#1363
iMacTia merged 2 commits intomainfrom
docs-20-upgrading-examples

Conversation

@olleolleolle
Copy link
Copy Markdown
Member

Description

To improve the UPGRADING docs' usability, this change makes the examples stand out more. I made them monospaced, so as to be more copypastable.

In order to make these stand out more, I made them monospaced, so more copypastable.
Copy link
Copy Markdown
Member

@iMacTia iMacTia left a comment

Choose a reason for hiding this comment

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

Thanks for the improvements! I noted a slight issue with the require, looks good otherwise!

Comment thread UPGRADING.md
`faraday` altogether as these gems usually have Faraday already in their dependencies.
`faraday` altogether as these gems usually have Faraday already in their dependencies. Example Gemfile line:
```ruby
gem 'faraday-net_http'
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

When requiring, this should be faraday/net_http

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Unrelated: Right. I peeked in the Gemfile description, of the kwarg "require:" for gem, but it doesn't fully help the user.

https://bundler.io/v2.2/man/gemfile.5.html#REQUIRE-AS

I'll improve the documentation on "what to do in the app code".

Copy link
Copy Markdown
Member

@iMacTia iMacTia left a comment

Choose a reason for hiding this comment

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

Thanks for the addition!

@iMacTia iMacTia merged commit 565f463 into main Jan 5, 2022
@iMacTia iMacTia deleted the docs-20-upgrading-examples branch January 5, 2022 08:34
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.

2 participants