docs: clarify default parameter behavior in section Quickening it Up and fix Portuguese translation typo
Bewertung
- Schwierigkeit
- 1/5
- Geschätzter Aufwand
- Unter einer Stunde
- Anfängerfreundlichkeit
- 40/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Veraltet
- Tech-Stack
- ruby
- Bereich
- documentation
Rechercherichtung
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.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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.
- Vorherrschende Sprache
- Ruby
- Sterne
- 258
- Forks
- 113
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Kein Beitragsleitfaden
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus ruby/TryRuby
-
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 64/100
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 25/100
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 48/100
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 48/100
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 25/100
Ähnliche Issues
-
🐛 bug 👩💻 équipe CE 🧑🏭 entreprises
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
betagouv/conseillers-entreprises#4808 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
yosiat/panko_serializer#250 ·
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 75/100
cline/mcp-marketplace#3886 ·
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100