Skip to content

Update Setup Instructions for Modern Ruby & Bundler Versions #207

@saitejareddy05

Description

@saitejareddy05

Description:
The current setup guide specifies Ruby 2.6 and Bundler 2.0.1, which are outdated and may cause compatibility issues for new contributors. Many systems now default to Ruby 3.x, leading to gem conflicts and installation errors when following the existing instructions.

Steps to Reproduce:

  • Install Ruby 3.x (default on most modern systems).
  • Run bundle install with Bundler 2.0.1.
  • Observe dependency conflicts and errors during Jekyll build.

Suggested Fix:

  • Update documentation to support Ruby 3.x and Bundler 2.5+.
  • Add a troubleshooting section for common gem conflicts.
  • Provide a Gemfile.lock update or Docker-based setup for consistency.

Impact:
This will make onboarding smoother for new contributors, reduce setup errors, and ensure long-term maintainability of the project.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions