Gem is misnamed causing additional work during implementation
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 28/100
- Loại issue
- Tái cấu trúc
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- ruby
- Lĩnh vực
- api, documentation
Hướng nghiên cứu
Bắt đầu với stream-chat.gemspec, lib/stream-chat.rb và các phần Installation và Getting Started của README. So sánh hai hướng đặt tên được đề xuất và xác nhận quyết định về tính tương thích và việc phát hành với các maintainer trước khi thay đổi bất kỳ điều gì. Được xem là hoàn tất khi hướng được chọn nhất quán trong gemspec, điểm vào require, README và kế hoạch release trong tương lai.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
The main file in this gem is lib/stream-chat.rb. The gemspec is named stream-chat.gemspec.
The "-ruby" part of the name is redundant in a Ruby gem name. With all that in mind, the gem should have been published under the name stream-chat. That name is not in use in Rubygems, so that is currently possible.
By not having the name of the gem not matching the name of the main file, the additional step of calling `require "stream-chat" is necessary. That's not standard or expected in the Ruby world, it would only be expected if the gem has files that should only be included under limited and specific conditions, like test harnesses.
So here are two possible paths to improve this:
Change the name of the gem:
- Change the name in the gemspec file to
stream-chat - Update the README to use the new name in the Installation section, and remove the
requirecall in the Getting Started section - Publish new versions to rubygems under the new name (and potentially also the old name)
Downside of simply renaming the gem going forward is that those using the gem under the old name would no longer receive new versions of the gem, unless it's published under both names going forward.
Remove the need for an additional require call:
- Add a file named
lib/stream-chat-ruby.rbwhich callsrequire "stream-chat" - Update the README to remove the
requirecall in the Getting Started section
- Ngôn ngữ chính
- Ruby
- Star
- 32
- Fork
- 23
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của GetStream/stream-chat-ruby
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100
GetStream/stream-chat-ruby#215 ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100
GetStream/stream-chat-ruby#137 ·
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100
GetStream/stream-chat-ruby#133 ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 35/100
GetStream/stream-chat-ruby#132 · 1 bình luận ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 45/100
GetStream/stream-chat-ruby#127 ·
Tất cả issue của GetStream/stream-chat-ruby
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
rubys/roundhouse#444 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 90/100
sclorg/s2i-ruby-container#656 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
yegor256/rubocop-elegant#92 ·
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
ecosyste-ms/awesome#812 ·
Maintainer thường phản hồi trong vòng 2 ngày