Skip to content

Commit d39e056

Browse files
authored
Merge branch 'master' into patch-2
2 parents fc9b889 + 57d1830 commit d39e056

File tree

76 files changed

+1817
-194
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

76 files changed

+1817
-194
lines changed

Gemfile.lock

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,13 +34,13 @@ GEM
3434
sassc (> 2.0.1, < 3.0)
3535
jekyll-watch (2.2.1)
3636
listen (~> 3.0)
37-
json (2.6.1)
37+
json (2.6.2)
3838
kgio (2.11.4)
39-
kramdown (2.3.2)
39+
kramdown (2.4.0)
4040
rexml
4141
kramdown-parser-gfm (1.1.0)
4242
kramdown (~> 2.0)
43-
lanyon (0.4.3)
43+
lanyon (0.4.4)
4444
jekyll (>= 2.0)
4545
rack (>= 1.6, < 3.0)
4646
liquid (4.0.3)
@@ -49,18 +49,18 @@ GEM
4949
rb-inotify (~> 0.9, >= 0.9.10)
5050
mercenary (0.4.0)
5151
mini_portile2 (2.8.0)
52-
minitest (5.15.0)
53-
nokogiri (1.13.4)
52+
minitest (5.16.2)
53+
nokogiri (1.13.6)
5454
mini_portile2 (~> 2.8.0)
5555
racc (~> 1.4)
5656
nokogumbo (2.0.5)
5757
nokogiri (~> 1.8, >= 1.8.4)
5858
paint (2.2.1)
5959
pathutil (0.16.2)
6060
forwardable-extended (~> 2.6)
61-
public_suffix (4.0.6)
61+
public_suffix (4.0.7)
6262
racc (1.6.0)
63-
rack (2.2.3)
63+
rack (2.2.4)
6464
rack-protection (2.2.0)
6565
rack
6666
rack-rewrite (1.5.1)
@@ -72,7 +72,7 @@ GEM
7272
rb-inotify (0.10.1)
7373
ffi (~> 1.0)
7474
rexml (3.2.5)
75-
rouge (3.28.0)
75+
rouge (3.29.0)
7676
safe_yaml (1.0.5)
7777
sassc (2.4.0)
7878
ffi (~> 1.9)

_data/downloads.yml

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,12 +15,10 @@ stable:
1515
# optional
1616
security_maintenance:
1717

18-
- 2.6.10
19-
2018
# optional
2119
eol:
2220

23-
- 2.5.9
21+
- 2.6.10
2422

2523
stable_snapshots:
2624

@@ -45,13 +43,6 @@ stable_snapshots:
4543
zip: https://cache.ruby-lang.org/pub/ruby/snapshot/snapshot-ruby_2_7.zip
4644
version: '2.7'
4745

48-
- branch: ruby_2_6
49-
url:
50-
gz: https://cache.ruby-lang.org/pub/ruby/snapshot/snapshot-ruby_2_6.tar.gz
51-
xz: https://cache.ruby-lang.org/pub/ruby/snapshot/snapshot-ruby_2_6.tar.xz
52-
zip: https://cache.ruby-lang.org/pub/ruby/snapshot/snapshot-ruby_2_6.zip
53-
version: '2.6'
54-
5546
nightly_snapshot:
5647

5748
url:

_includes/analytics.html

Lines changed: 0 additions & 13 deletions
This file was deleted.

_layouts/default.html

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,5 @@ <h2>{{ site.data.locales[page.lang].slogan }}</h2>
7878
{% include credits.html %}
7979
</div>
8080
</div>
81-
82-
{% include analytics.html %}
8381
</body>
8482
</html>

bg/community/user-groups/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,4 @@ lang: bg
3333

3434

3535

36-
[meetup]: https://ruby.meetup.com
36+
[meetup]: https://www.meetup.com/topics/ruby/

de/community/ruby-core/index.md

Lines changed: 90 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -4,144 +4,132 @@ title: "Ruby Core"
44
lang: de
55
---
66

7-
Jetzt ist die beste Zeit, die weitere Entwicklung von Ruby zu verfolgen,
8-
denn Ruby 2.0 ist in Arbeit. Durch das erhöhte Interesse an Ruby,
9-
das sich in den letzten Jahren entwickelt hat, besteht ein
10-
steigender Bedarf an Talenten, die bei der Verbesserung von Ruby und der
11-
Dokumentation seiner Teile mitwirken. Also, womit willst Du anfangen?
7+
Jetzt ist die beste Zeit, die weitere Entwicklung von Ruby zu verfolgen.
8+
Durch das in den letzten Jahren gestiegene Interesse an Ruby besteht ein
9+
wachsender Bedarf an Talenten, die bei der Verbesserung von Ruby und der
10+
Dokumentation seiner Bestandteile mitwirken. Also, womit willst Du anfangen?
1211
{: .summary}
1312

1413
Die hier behandelten Themen zur Entwicklung von Ruby sind Folgende:
1514

16-
* [Subversion zur Entwicklung von Ruby nutzen](#following-ruby)
17-
* [Mit Git arbeiten](#git-ruby)
15+
* [Die Ruby-Entwicklung über Git verfolgen](#following-ruby)
1816
* [Ruby verbessern, Patch für Patch](#patching-ruby)
19-
* [Regeln für Core-Entwickler](#coding-standards)
17+
* [Hinweis zu Branches](#branches-ruby)
2018

21-
### Subversion zur Entwicklung von Ruby nutzen
19+
### Die Ruby-Entwicklung über Git verfolgen
2220
{: #following-ruby}
2321

24-
Mit dem folgenden Kommandozeilenbefehl kannst du den aktuellsten
25-
Quelltext von Ruby über Subversion herunterladen (auschecken):
22+
Das aktuelle Haupt-Repository mit dem neuesten Ruby-Quellcode ist
23+
[git.ruby-lang.org/ruby.git][gitrlo].
24+
Zusätzlich existiert auch ein [Mirror auf GitHub][7]. Verwende im Allgemeinen bitte diesen Mirror.
25+
26+
Du kannst über Git den neuesten Quellcode von Ruby beziehen.
27+
Von deiner Kommandozeile:
2628

2729
{% highlight sh %}
28-
$ svn co https://svn.ruby-lang.org/repos/ruby/trunk ruby
30+
$ git clone https://github.com/ruby/ruby.git
2931
{% endhighlight %}
3032

31-
Das Verzeichnis `ruby` enthält nun den vollständigen Quelltext der
32-
Entwicklerversion Ruby 1.9. Bitte bedenke, dass es sich bei dieser
33-
Version um die absolut neuste Variante von Ruby handelt. Sie wird
34-
ständig weiterentwickelt und wird erst am Ende des Jahres 2007 offiziell
35-
veröffentlicht.
33+
Der Ordner `ruby` wird jetzt den neuesten Quellcode für die Entwicklungsversion von Ruby beinhalten (ruby-trunk).
34+
35+
Siehe dazu auch das Dokument [Non-committer’s HOWTO to join our development][noncommitterhowto].
3636

37-
Wenn du Interesse an der Verbesserung von Ruby 1.8 hast, solltest du dir
38-
den Branch `ruby_1_8` genauer anschauen. Über den folgenden
39-
Kommandozeilenbefehl kannst du den Quelltext auschecken:
37+
Wenn du Commit-Berechtigung hast und etwas pushen möchtest, solltest du
38+
das Haupt-Repository verwenden.
4039

4140
{% highlight sh %}
42-
$ svn co https://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8
41+
$ git clone git@git.ruby-lang.org:ruby.git
4342
{% endhighlight %}
4443

45-
Damit hast du die aktuelle Entwicklerversion des offiziellen Ruby 1.8
46-
Zweiges in das Verzeichnis `ruby_1_8` heruntergeladen. Entwickler, die
47-
einen Patch für diese Version entwickeln, werden darum gebeten ebenfalls
48-
einen Patch für die Entwicklerversion 1.9 zu erstellen. Aufgrund dessen
49-
sollten die Versionen 1.8 und 1.9 sich einander ähneln, mit der Ausnahme
50-
von Erweiterungen an der Sprache Ruby selbst.
44+
### Ruby verbessern, Patch für Patch
45+
{: #patching-ruby}
5146

52-
Bei Interesse besteht die Möglichkeit das [Ruby-Repository über den
53-
Webbrowser][1] zu begutachten.
47+
Das Kernteam betreibt einen [Issue-Tracker][10] für das Beisteuern von Patches
48+
und Fehlerberichte an Matz und die Gang. Diese Berichte werden auch an die [Ruby-Core Mailingliste][mailing-lists] zur Diskussion gesendet. So kannst du
49+
sicher sein, dass deine Anfrage nicht unbemerkt bleibt.
50+
Du kannst Patches auch direkt an die Mailingliste senden. Wie auch immer,
51+
du bist herzlich eingeladen an der entstehenden Diskussion teilzunehmen.
5452

55-
Für weiterführende Informationen bezüglich Subversion bietet sich die
56-
englischsprachige [Subversion-FAQ][2] und das ebenfalls
57-
englischsprachige [Subversion-Buch][3] an.
53+
Bitte schau dir den [Leitfaden für Patch-Autoren][writing-patches] an.
54+
Dort findest du einige Tips direkt von Matz dazu, wie deine Patches berücksichtigt werden können.
5855

59-
### Mit Git arbeiten
60-
{: #git-ruby}
56+
Als Zusammenfassung, die Schritte zur Erstellung eines Patches sind:
6157

62-
Diejenigen, die [Git][4] bevorzugen, können einen [Mirror auf GitHub][5]
63-
nutzen. Dieser kann von [offiziellen Committern][6] und [allen
64-
Anderen][7] benutzt werden.
58+
1. Checke den Ruby-Quellcode von GitHub aus.
59+
Patches für Bugfixes oder neue Features sollten für den `trunk` von
60+
Rubys Quellcode abgegeben werden.
6561

66-
### Ruby verbessern, Patch für Patch
67-
{: #patching-ruby}
62+
$ git clone https://github.com/ruby/ruby.git
6863

69-
Rubyforge bietet einen [Bug-Tracker][8] für das Melden von Fehlern und
70-
Übersenden von Patches an Matz und die Anderen. Die Fehlerreports gehen
71-
parallel auch zur Diskussion an die Ruby-Core-Mailingliste, wodurch keine
72-
Fehlermeldung unbeachtet bleibt.
64+
Wenn du einen Bug in einem Maintenance-Branch fixen willst, dann checke
65+
eine Kopie dieses Branches aus.
7366

74-
Zusammenfassend sind folgende Schritte für das Erstellen eines Patches
75-
erforderlich:
67+
$ git checkout ruby_X_X
7668

77-
1. Eine Kopie von Ruby 1.8 auschecken. Dabei das Tag
78-
`ruby_1_8` verwenden.
69+
X_X sollte durch die auszucheckende Version ersetzt werden.
7970

80-
$ cvs -z4 -d :pserver:anonymous@cvs.ruby-lang.org:/src \
81-
co -r ruby_1_8 -d ruby-1.8 ruby
71+
2. Füge deine Verbesserungen zum Code hinzu.
8272

83-
2. Hinzufügen der eigenen Verbesserungen (im Verzeichnis `ruby-1.8`).
84-
3. Einen Patch erstellen.
73+
3. Erstelle einen Patch.
8574

86-
$ cvs diff > ruby-1.8-changes.patch
75+
$ git diff > ruby-changes.patch
8776

88-
4. [Abschicken][9] des neuen Patches.
77+
4. Erstelle ein Ticket im [Issue-Tracker][10] oder maile deinen Patch an
78+
die [Ruby-Core Mailingliste][mailing-lists] mit einem ChangeLog-Eintrag
79+
zu deinem Patch.
8980

90-
**Bitte beachten:** Patches sollten als [unified diff][10] abgeschickt
91-
werden. Wer mehr über das Zusammenführen (Merge) der Patches wissen will,
92-
sollte sich die [diffutils-Referenz][11] ansehen.
81+
5. Wenn zu dem Patch keine Bedenken angemeldet werden, dann wird den
82+
Committern die Berechtigung erteilt, ihn zu übernehmen.
9383

94-
Diskussionen zum Thema Ruby-Entwicklung werden in der
95-
[Ruby-Core-Mailingliste][mailing-lists] gebündelt.
96-
Wer herausfinden will, ob sein Patch Sinn macht oder nur eine Diskussion
97-
über die Zukunft von Ruby anfangen will, sollte nicht zögern an Bord zu
98-
kommen. Es wird an dieser Stelle davor gewarnt, Off-Topic Diskussionen
99-
zu führen, da diese in der Liste nicht akzeptiert werden. Es sollte klar
100-
kommuniziert und aussagekräftige Überschriften verwendet werden.
101-
Schließlich wird hier der Erfinder von Ruby angesprochen, daher lasst
102-
uns ein wenig Respekt haben.
84+
**Bitte beachte:** Patches sollten als [unified diff][12] abgegeben werden.
85+
Siehe [die diffutils Referenz][13] für mehr Informationen dazu, wie Patches übernommen werden.
10386

104-
Es sollte klar sein, dass das Kernteam in Japan lebt. Obwohl die meisten
105-
sehr gut Englisch sprechen, gibt es aber auch noch einen signifikanten
106-
Unterschied in der Zeitzone zu beachten. Es existieren übrigens auch
107-
komplett japanischsprachige Listen neben den englischen Pendants. Man
108-
sollte nur die Ruhe bewahren, wenn eine Antwort nicht sofort
109-
zurückkommt. Notfalls kann die gleiche Anfrage ein paar Tage später
110-
nochmal gestellt werden.
87+
Die Diskussion zur Ruby-Entwicklung findet auf der
88+
[Ruby-Core Mailingliste][mailing-lists] statt. Wenn du also neugierig bist,
89+
ob sich dein Patch lohnt oder du eine Diskussion zur Zukunft von Ruby
90+
starten möchtest, dann zögere nicht, an Bord zu kommen.
91+
Sei gewarnt: Off-Topic-Diskussionen werden auf dieser Liste nicht toleriert.
92+
Der Lärmpegel sollte niedrig, Themen sollten pointiert, gut durchdacht
93+
und formuliert sein. Da wir uns an den Schöpfer von Ruby wenden, sollten
94+
wir etwas Ehrfurcht an den Tag legen.
11195

112-
### Regeln für Core-Entwickler
113-
{: #coding-standards}
96+
Behalte im Hinterkopf, dass viele Kernentwickler von Ruby in Japan leben.
97+
Viele sprechen hervorragendes Englisch, aber trotzdem bleibt ein erheblicher
98+
Zeitzonen-Unterschied.
99+
Außerdem gibt es neben den englischen auch eine ganze Menge japanische Entwicklungs-Mailinglisten. Sei geduldig. Wenn deine Anfrage nicht gelöst wird,
100+
dann bleib dran - versuch es ein paar Tage später nochmal.
114101

115-
Allgemein sollten Entwickler von Ruby mit den Quelltexten und dem
116-
Entwicklungstil des Teams vertraut sein. Zum besseren Verständnis
117-
sollten die folgenden Richtlinien beim Einchecken ins
118-
Subversion-Repository beachtet werden:
102+
### Hinweis zu Branches
103+
{: #branches-ruby}
104+
105+
Der Ruby-Quellcode wurde bis zum 22. April 2019 über Subversion verwaltet.
106+
Daher werden manche Zweige immer noch über Subversion gepflegt.
107+
Du kannst das SVN-Repository betrachten.
108+
109+
* [&lt;URL:https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?root=ruby&gt;][svn-viewvc]
110+
111+
Normalerweise musst du dich darum aber nicht kümmern (außer wenn du ein
112+
Branch-Maintainer bist).
113+
Du kannst Branches in deiner Git-Arbeitskopie auschecken,
114+
zum Beispiel über folgendes Kommando.
115+
116+
{% highlight sh %}
117+
$ git checkout ruby_X_X
118+
{% endhighlight %}
119119

120-
* Alle Änderungen sollten im `ChangeLog` gemäß den
121-
[GNU-Konventionen][12] erfasst werden. (Viele Core-Entwickler von Ruby
122-
nutzen den `add-log` Modus von Emacs: `C-x 4 a`.)
123-
* Der Check-in Zeitstempel sollte in Japan Standard Time (UTC+9)
124-
angegeben werden.
125-
* Die Punkte im ChangeLog sollten als Kommentar beim Einchecken
126-
verwendet werden. Dieser Kommentar wird automatisch nach einem Commit
127-
an die Ruby-CVS-Liste gemailt.
128-
* Funktionsprototypen werden überall im Ruby-Quelltext verwendet.
129-
* Bitte keine C++-Kommentare (`//`) verwenden. Das Ruby-Wartungsteam
130-
bevorzugt stattdessen die Mehrzeilenkommentare von Standard-C
131-
(`/* .. */`).
120+
X_X sollte durch die auszucheckende Version ersetzt werden.
132121

122+
Wenn du die Zweige modifizieren möchtest, dann öffne bitte ein Issue im
123+
[Issue-Tracker][10].
124+
Siehe auch den nachfolgenden Abschnitt.
133125

134126

127+
[gitrlo]: https://git.ruby-lang.org/ruby.git
135128
[mailing-lists]: /de/community/mailing-lists/
136-
[1]: https://svn.ruby-lang.org/cgi-bin/viewvc.cgi/
137-
[2]: http://subversion.apache.org/faq.html
138-
[3]: http://svnbook.org
139-
[4]: http://git-scm.com/
140-
[5]: https://github.com/ruby/ruby
141-
[6]: https://github.com/shyouhei/ruby/wiki/committerhowto
142-
[7]: https://github.com/shyouhei/ruby/wiki/noncommitterhowto
143-
[8]: http://rubyforge.org/tracker/?func=browse&amp;group_id=426&amp;atid=1698
144-
[9]: http://rubyforge.org/tracker/?func=add&amp;group_id=426&amp;atid=1700
145-
[10]: http://www.gnu.org/software/diffutils/manual/html_node/Unified-Format.html
146-
[11]: http://www.gnu.org/software/diffutils/manual/html_node/Merging-with-patch.html#Merging%20with%20patch
147-
[12]: http://www.gnu.org/prep/standards/standards.html#Change-Logs
129+
[writing-patches]: /de/community/ruby-core/writing-patches/
130+
[noncommitterhowto]: https://github.com/shyouhei/ruby/wiki/noncommitterhowto
131+
[svn-viewvc]: https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?root=ruby
132+
[7]: https://github.com/ruby/ruby
133+
[10]: https://bugs.ruby-lang.org/
134+
[12]: http://www.gnu.org/software/diffutils/manual/html_node/Unified-Format.html
135+
[13]: http://www.gnu.org/software/diffutils/manual/html_node/Merging-with-patch.html#Merging%20with%20patch
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
layout: page
3+
title: "Leitfaden für Patch-Autoren"
4+
lang: de
5+
---
6+
7+
Hier findest du einige Tips direkt von Matz dazu, wie deine Patches berücksichtigt werden können.
8+
{: .summary}
9+
10+
Diese Richtlinien wurden von einem [Post von Matz][ruby-core-post]
11+
auf der Ruby-Core Mailingliste übernommen und angepasst:
12+
13+
* Implementiere eine Änderung pro Patch
14+
15+
Das ist das größte Hindernis für die meisten verzögerten Patches.
16+
Wenn du einen Patch sendest, der gleichzeitig mehrere Bugs behebt
17+
(und Features hinzufügt), dann müssen wir sie vor der Übernahme auftrennen.
18+
Das ist für uns geschäftige Entwickler eine mühsame Aufgabe.
19+
Daher werden solche Patches oft verzögert. Bitte keine großen Patches.
20+
21+
* Liefere Beschreibungen
22+
23+
Manchmal beschreibt ein bloßer Patch das gelöste Problem nicht hinreichend.
24+
Eine bessere Beschreibung (das behobene Problem, Vorbedigungen, Plattform
25+
etc.) würde für eine zügige Übernahme helfen.
26+
27+
* Verwende die aktuellste Revision
28+
29+
Dein Problem könnte in der aktuellsten Revision bereits gelöst sein.
30+
Oder der Code ist dort vielleicht bereits völlig anders.
31+
Vor dem Senden eines Patches solltest du bitte die aktuellste Version laden
32+
(der `trunk` Branch für die neueste Entwicklungsversion,
33+
`{{ site.svn.stable.branch }}` für {{ site.svn.stable.version }}) aus dem Subversion-Repository.
34+
35+
* Verwende `diff -u`
36+
37+
Wir verwenden lieber `diff -u` Unified-Diff-Patches als `diff -c` oder
38+
andere Patchformate. Diese sind viel leichter zu begutachten.
39+
Sende keine ganzen modifizierten Dateien, denn wir wollen nicht selbst einen
40+
Diff erstellen.
41+
42+
* Liefere Test-Cases (optional)
43+
44+
Ein Patch mit Test-Cases (vorzugsweise ein Patch zu `test/*/test_*.rb`)
45+
würde uns helfen, den Patch und deine Absicht besser zu verstehen.
46+
47+
In Zukunft wechseln wir vielleicht auf einen Git-Workflow mit Pull-Requests.
48+
Aber bis dahin wird das Befolgen dieser Richtlinien Frustration vermeiden.
49+
50+
[ruby-core-post]: http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-core/25139

de/documentation/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ deutschsprachigen Artikeln. Für weitergehende Fragen steht eine große
8181
[8]: http://www.approximity.com/rubybuch2/
8282
[9]: http://www.ruby-doc.org/core
8383
[10]: http://www.ruby-doc.org/stdlib
84-
[extensions]: https://docs.ruby-lang.org/en/master/doc/extension_rdoc.html
84+
[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
8585
[12]: http://www.rubydoc.info/
8686
[13]: http://ruby-doc.org
8787
[14]: http://wiki.ruby-portal.de

0 commit comments

Comments
 (0)