docs: German translation of benchmark howto

rubinius · Mar 23, 2011 · 7b6c5b3 · 7b6c5b3
1 parent 7978522
commit 7b6c5b3
Show file tree

Hide file tree

Showing 5 changed files with 41 additions and 4 deletions.
diff --git a/web/doc/de/how-to.markdown b/web/doc/de/how-to.markdown
@@ -11,6 +11,7 @@ review: true
 1. [Ein Ticket erstellen](/doc/de/how-to/write-a-ticket/)
 1. [Ein Ruby Spec schreiben](/doc/de/how-to/write-a-ruby-spec/)
 1. [Einen fehlgeschlagenen Spec reparieren](/doc/de/how-to/fix-a-failing-spec/)
+1. [Benchmarks schreiben](/doc/de/how-to/write-benchmarks)
 1. [Einen Blogeintrag schreiben](/doc/de/how-to/write-a-blog-post/)
 1. [Dokumentation schreiben](/doc/de/how-to/write-documentation/)
 1. [Dokumentation übersetzen](/doc/de/how-to/translate-documentation/)
diff --git a/web/doc/de/how-to/fix-a-failing-spec.markdown b/web/doc/de/how-to/fix-a-failing-spec.markdown
@@ -3,8 +3,8 @@ layout: doc_de
 title: Anleitung - Einen fehlgeschlagenen Spec reparieren
 previous: Einen Ruby Spec schreiben
 previous_url: how-to/write-a-ruby-spec
-next: Einen Blogeintrag schreiben
-next_url: how-to/write-a-blog-post
+next: Benchmarks schreiben
+next_url: how-to/write-benchmarks
 ---
 
 Die folgenden Abschnitte solltest du gelesen haben:

diff --git a/web/doc/de/how-to/write-a-blog-post.markdown b/web/doc/de/how-to/write-a-blog-post.markdown
@@ -1,8 +1,8 @@
 ---
 layout: doc_de
 title: Anleitung - Einen Blogeintrag schreiben
-previous: Einen fehlgeschlagenen Spec reparieren
-previous_url: how-to/fix-a-failing-spec
+previous: Benchmarks schreiben
+previous_url: how-to/write-benchmarks
 next: Dokumentation schreiben
 next_url: how-to/write-documentation
 ---

diff --git a/web/doc/de/how-to/write-benchmarks.markdown b/web/doc/de/how-to/write-benchmarks.markdown
@@ -0,0 +1,35 @@
+---
+layout: doc_de
+title: Anleitung - Benchmarks schreiben
+previous: Einen fehlgeschlagenen Spec reparieren
+previous_url: how-to/fix-a-failing-spec
+next: Einen Blogeintrag schreiben
+next_url: how-to/write-a-blog-post
+---
+
+Warum Benchmarks?
+
+Benchmarks sind ein hervorragendes Hilfsmittel, um Rubinius mit den anderen
+Ruby Implementationen, wie z.B. MRI, JRuby, IronRuby und anderen, zu
+vergleichen. Dabei geht es weniger darum, Rubinius selber zu messen, sondern
+Vergleichswerte zu erzielen. Möchtest du Benchmarks schreiben, dann achte bitte
+auf folgende Richtlinien:
+
+  1.  Schau dir bestehende Benchmarks unter rubinius/benchmarks an und versuche
+      dem Schema zu folgen.
+  2.  Jede Benchmark-Datei sollte sich auf einen besonderen Aspekt von Ruby
+      konzentrieren, beispielsweise dem Löschen von Schlüsseln und Werten in 
+      Hashes.
+  3.  Verwende das interne Benchmark-Framework.
+  4.  Benchmarks sollten kurz und prägnant sein.
+  5.  Die Benchmarks messen nicht Rubinius. Schreibst du also ein Benchmark für
+      eine Klasse, die über sog. Bang-Methoden (also das Objekt verändernde 
+      Methoden, meist mit einem Ausrufezeichen versehen) und 
+      Nicht-Bang-Methoden verfügt, dann solltest du für die Bang-Methode das
+      Objekt duplizieren, nicht jedoch für die Nicht-Bang-Methode.
+
+Zum Testen der Benchmarks kannst einzelne Dateien oder auch ganze Ordner 
+übergeben:
+
+    bin/benchmark benchmark/core/string/bench_case.rb
+    bin/benchmark benchmark/core
diff --git a/web/doc/de/index.markdown b/web/doc/de/index.markdown
@@ -59,6 +59,7 @@ next_url: what-is-rubinius
     1. [Ein Ticket erstellen](/doc/de/how-to/write-a-ticket/)
     1. [Einen Ruby Spec schreiben](/doc/de/how-to/write-a-ruby-spec/)
     1. [Einen fehlgeschlagenen Spec reparieren](/doc/de/how-to/fix-a-failing-spec/)
+    1. [Benchmarks schreiben](/doc/de/how-to/write-benchmarks)
     1. [Einen Blogeintrag schreiben](/doc/de/how-to/write-a-blog-post/)
     1. [Dokumentation schreiben](/doc/de/how-to/write-documentation/)
     1. [Dokumentation übersetzen](/doc/de/how-to/translate-documentation/)