GSTT-CSC / GSTT-CSC/gstt-csc.github.io

Project fails to build due to gemspec constraints and outdated jekyll version

Open
#633 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
5
Forks
8
Avg merge
13h 46m
Merged PRs (30d)
6

Description

## Problem description

Cloning the repository and running `bundle install` fails or behaves unexpectedly because of:

- A `.gemspec` file that restricts `jekyll` to `< 4.3`, preventing installation with Ruby >= 3.4.
- The use of `gemspec` in the `Gemfile`, which defers all dependency logic to the `.gemspec`.

As a result, contributors face errors or have to manually edit the project structure to get it working locally.

## Proposed solution

- Remove the `.gemspec` file entirely, since the project is a static website and not intended for gem publishing.
- Remove the `gemspec` line from the `Gemfile`.
- Move all necessary dependencies directly into the `Gemfile` with clear version specifications.
- Use `~> 4.2` for `jekyll` to remain compatible with Ruby 3.4+ and allow non-breaking patch updates.

## Benefits

- Simplifies setup with `bundle install`.
- Ensures compatibility with recent Ruby and Jekyll versions.
- Avoids confusion for new contributors.
- Removes unnecessary coupling to a `.gemspec`.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.