Skip to content

Commit

Permalink
docs: improve Ruby documentation (#7991)
Browse files Browse the repository at this point in the history
Co-authored-by: Michael Kriese <michael.kriese@visualon.de>
  • Loading branch information
HonkingGoose and viceice committed Dec 15, 2020
1 parent 303449a commit 93bf122
Showing 1 changed file with 11 additions and 19 deletions.
30 changes: 11 additions & 19 deletions docs/usage/ruby.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,21 @@
---
title: Ruby Bundler Support
title: Ruby Bundler support
description: Ruby Bundler support in Renovate
---

# Automated Dependency Updates for Ruby Bundler Dependencies
# Automated dependency updates for Ruby Bundler dependencies

Renovate supports upgrading dependencies in Bundler's `Gemfile`s and their accompanying `Gemfile.lock` files.
Support is considered "alpha" stage until there have been some more real-world tests.
Renovate supports upgrading dependencies in Bundler's Gemfiles and their accompanying `Gemfile.lock` files.

## How It Works
## How it works

1. Renovate will search each repository for any `Gemfile` files
2. Existing dependencies will be extracted from the files
3. Renovate will resolve the dependency on Rubygems or elsewhere if configured, and look for any newer versions
4. A PR will be created with `Gemfile` and `Gemfile.lock` updated in the same commit
5. If the source repository has either a "changelog" file or uses GitHub releases, then Release Notes for each version will be embedded in the generated PR
1. Renovate searches in each repository for any Gemfiles
1. Existing dependencies are extracted from the Gemfiles
1. Renovate resolves the dependency on Rubygems.org (or elsewhere if configured), and checks for newer versions
1. A PR is created which updates the `Gemfile` and `Gemfile.lock` in a single commit
1. If the source repository has a "changelog" file or uses GitHub releases, then Release Notes for each version are embedded in the generated PR

## Enabling

Either install the [Renovate App](https://github.com/apps/renovate) on GitHub, or check out [Renovate OSS](https://github.com/renovatebot/renovate) for self-hosted.
Bundler support is now enabled by default in both.

## Future work

- Updating `.gemspec` files
- Pinning dependencies to the version found in `Gemfile.lock` rather than the latest matching version
- Lock file maintenance
- Selective lock file updating (if ranges are in use in the `Gemfile`)
You can install the [Renovate App](https://github.com/apps/renovate) on GitHub.
Or you can check out [Renovate OSS](https://github.com/renovatebot/renovate) to self-host Renovate.

0 comments on commit 93bf122

Please sign in to comment.