docs: clarify default parameter behavior in section Quickening it Up and fix Portuguese translation typo
Đánh giá
- Độ khó
- 1/5
- Thời gian dự kiến
- Dưới một giờ
- Mức phù hợp với người mới
- 40/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- ruby
- Lĩnh vực
- documentation
Hướng nghiên cứu
Open the "Quickening it Up" section of the tutorial and its Portuguese counterpart, and locate the paragraph describing the initialize default argument (content="" / conteudo=""). Compare the two texts: the English one needs the wording softened to say the default only applies when the argument is omitted, and the Portuguese one additionally carries a stray __. Make the prose match across translations with consistent inline code around parameter names, then view the rendered pages to confirm. Note an open pull request (#266) already targets this, so check it before starting to avoid duplicate work.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Section: Quickening it Up
Description
The Ruby tutorial's explanation of the initialize method contains two issues:
1. Misleading explanation (identified in both English and Portuguese)
Both versions suggest that the default argument (content="" / conteudo="") guarantees the parameter is a string.
However, the default value only applies when the argument is omitted. Passing nil or another incompatible value explicitly can still cause an error.
Suggested wording (English):
"The default value content="" ensures that content is an empty string when no argument is provided."
Suggested wording (Portuguese):
"O valor padrão conteudo="" garante que conteudo seja uma string vazia quando nenhum argumento for informado."
2. Formatting typo (Portuguese only)
The Portuguese translation contains an unexpected __ in the paragraph explaining the default parameter. This does not appear in others version.
Expected behavior
- Both translations accurately describe Ruby's default argument behavior.
- The Portuguese version no longer contains the unintended
__. - Parameter names and values use consistent inline code formatting.
- Ngôn ngữ chính
- Ruby
- Star
- 258
- Fork
- 113
- 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
- Có Dockerfile hoặc tệp Docker Compose
- Không có mẫu pull request
- Không 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 ruby/TryRuby
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 64/100
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 48/100
-
Occupied ports and notificationsĐang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100
-
Test system can be expandedĐang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100
Issue tương tự
-
🐛 bug 👩💻 équipe CE 🧑🏭 entreprises
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
betagouv/conseillers-entreprises#4808 ·
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 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 76/100
yosiat/panko_serializer#250 ·
-
[Server Submission]: Aspera CLIĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 75/100
cline/mcp-marketplace#3886 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100