Gute Anweisungen für Anfänger zum Erstellen minimaler vollständiger Fehlerbeispiele? [geschlossen]

9

Diejenigen von uns, die schon eine Weile Fragen beantwortet haben und sich mit Fehlerberichten beschäftigen, sind alle sehr vertraut mit dem Konzept eines "vollständigen, minimalen Beispiels". Du beginnst mit einem riesigen Haufen Code, der einen seltsamen Fehler hat, und du willst jemanden danach fragen. Aber du willst ihnen nicht das ganze Chaos schicken, also fängst du an, den Code in kleinere Stücke zu schneiden, bis du diesen kleinen kristallisierten 20-zeiligen Edelstein bekommst, der immer noch den gleichen Fehler hat wie du.

(Und dann, mindestens die Hälfte der Zeit, Sie erkennen, was der Fehler ist, weil es Sie wie eine Luna Motte im Gesicht starrt, und Sie müssen nicht fragen, aber das ist ein Nebeneffekt.)

Diese Art von Code-Reduktion ist keine Fähigkeit, die jeder hat - es braucht etwas Übung, abgesehen von der Tatsache, dass viele Neulinge noch nicht gelernt haben, dass sie es überhaupt tun sollten . Es gibt einige ausgezeichnete Anweisungen für Anfänger, wie man gute Fragen stellt (z. B. ESRs Klassiker "Fragen an den Smart Way"). Gibt es gute Anweisungen, die erklären, was genau ein minimales vollständiges Beispiel ist und wie und warum man es erstellt?

    
Brooks Moses 30.10.2010, 07:49
quelle

2 Antworten

3

Es ist alles im Namen. Ein vollständiges Minimalbeispiel ist ein vollständiges und minimales Beispiel. Complete bedeutet, dass es alle relevanten Informationen enthält und minimal bedeutet, dass es keine Informationen enthält, die nicht relevant sind. Die Fähigkeit, das zu identifizieren, was nicht relevant ist, ist etwas, das nur mit Übung einhergeht. Der Versuch, Anweisungen dafür zu geben, scheint ein bisschen so zu sein, als würde man versuchen, Anweisungen zum Fahrradfahren zu geben. Sie können die technische Erklärung geben und die Mechanik beschreiben (und die TeX FAQ, mit der Sie verlinkt haben, macht das sehr gut), aber am Ende ist der einzige Weg wirklich zu lernen, indem Sie es tun.

    
Benubird 26.11.2010, 10:59
quelle
2

Ich beginne damit mit denen, die mir vertraut sind; Diese beiden kommen aus der TeX-Community und sind daher etwas schräg für die Programmierung. Ich hoffe, dass andere Leute bessere Antworten haben.

In der UK TeX FAQ finden Sie unter Ссылка .

Diese Seite verweist auf einen etwas längeren Artikel über "Was ist ein minimales Arbeitsbeispiel?", hier: Ссылка . Auch dies ist für TeX-Dokumente; die Ideen sind die gleichen, aber die Werkzeuge und Details ein wenig anders.

Bearbeiten (2013/01): Eine weitere, die ich in einem StackOverflow-Kommentar bemerkt habe: Die Seite "Kurz, unabhängig, korrekt (kompilierbar), Beispiel" unter Ссылка . Nicht perfekt, und es schlägt 20kb (!) Als obere Grenze, aber eine gute Ergänzung der Liste.

Bearbeiten (2013/02): Jon Skeet hat einen Blogeintrag zum Schreiben von guten Fragen, der einen Abschnitt zu Beispielcode enthält, der nützlich erscheint: Ссылка

    
Brooks Moses 30.10.2010 07:53
quelle

Tags und Links