Verständlich Schreiben: Difference between revisions

From Chaosdorf Wiki
(Event data added)
No edit summary
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Event
{{Event
| Title = OpenChaos 2012-08
|Title=Verständlich Schreiben
| Description = Verständlich schreiben
|Description=OpenChaos April 2013
| Type = Workshop
|Type=Workshop
| Date = 2012-08-04
|Date=2013-04-13
| Start = 16:00 h
|Start=15:00
| Speaker = pallas
|Duration=3
| Host = nomaster
|Speaker=pallas
|Host=nomaster
}}
}}
''Dieser Vorschlag für OpenChaos war bereits einmal gebucht. Die Veranstaltung ist jedoch ausgefallen.''


== Ankündigungstext ==
= Links =
 
* Folien: https://docs.google.com/presentation/d/1EYqtCzz8doL6oqFWRjO8buUMI3ujeSIRH4npuJ7JZHI/edit?usp=sharing
* Übungsfolien: https://docs.google.com/document/d/1wRglFzNHQ26LLSQx-3IFtjKU7IB2PRYK9QD9UXUaPsI/edit?usp=sharing
* Artikel von SuShee: http://offiziere.ch/trust-us/ds/81/012.htm
 
 
= Ankündigungstext =


Wir alle freuen uns über gute Doku, wenn wir etwas Neues lernen. Doch wie sieht es mit der Doku für unsere eigenen Projekte aus? Ist sie a) vorhanden und b) verständlich geschrieben?
Wir alle freuen uns über gute Doku, wenn wir etwas Neues lernen. Doch wie sieht es mit der Doku für unsere eigenen Projekte aus? Ist sie a) vorhanden und b) verständlich geschrieben?
Line 20: Line 29:
Der Workshop orientiert sich an [http://offiziere.ch/trust-us/ds/81/012.htm diesem Artikel von Su-Shee]
Der Workshop orientiert sich an [http://offiziere.ch/trust-us/ds/81/012.htm diesem Artikel von Su-Shee]


= Übungen =
'''Ausgangstext'''<br>
Der erste Compiler (A-0) wurde 1952 von der Mathematikerin Grace Hopper kreirt. Programmierer reihten ausschließlich Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand und damit Symbolik der Mathematik sowie natürliche Sprache für die Programmierung erschloss. Am 3. Mai 1952 stellte Hopper erstmals öffentlich den ersten Compiler A-0 vor, der Algorithmen aus einem Katalog abrief, Code umschrieb, in passender Sequenz zusammenstellte, Speicherplatz reservierte und die Zuteilung von Speicheradressen organisierte. Anfang 1955 präsentierte Hopper bereits einen Prototyp des Compilers B-0, der nach englischen, französischen oder deutschen Instruktionen Programme erzeugte. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Die Geschichte des Compilerbaus wurde von den jeweils aktuellen Programmiersprachen und Hardwarearchitekturen geprägt. Weitere frühe Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler wurden aber erst in den 1960er Jahren entwickelt.
'''Endfassung'''<br>
Die Mathematikerin Grace Hopper entwickelte 1952 "A-0", den ersten Compiler. Vorher reihten Programmierer Nullen und Einsen aneinander. Durch den Compiler erschloss Hopper Symbolik der Mathematik und natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper A-0 in dem Vortrag „The Education of a Computer“ öffentlich vor. A-0 rief Algorithmen aus einem Katalog ab, schrieb Code um und sortierte ihn, reservierte Speicherplatz und teilte Speicheradressen zu.
Anfang 1955 zeigte Hopper einen Prototyp des Compilers B-0. Er erzeugte Programme nach englischen, französischen oder deutschen Anweisungen.
Weitere Meilensteine waren 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Funktionen heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
== So geht's ==
Kopien austeilen?
Textauszug kopiert und adaptiert (d.h. verschlimmert) von [http://de.wikipedia.org/wiki/Compiler#Geschichte Wikipedia/Compiler]
=== Ausgangstext ===
Der erste Compiler (A-0) wurde 1952 von der Mathematikerin Grace Hopper kreirt. Programmierer reihten ausschließlich Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand und damit Symbolik der Mathematik sowie natürliche Sprache für die Programmierung erschloss. Am 3. Mai 1952 stellte Hopper erstmals öffentlich den ersten Compiler A-0 vor, der Algorithmen aus einem Katalog abrief, Code umschrieb, in passender Sequenz zusammenstellte, Speicherplatz reservierte und die Zuteilung von Speicheradressen organisierte. Anfang 1955 präsentierte Hopper bereits einen Prototyp des Compilers B-0, der nach englischen, französischen oder deutschen Instruktionen Programme erzeugte. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Die Geschichte des Compilerbaus wurde von den jeweils aktuellen Programmiersprachen und Hardwarearchitekturen geprägt. Weitere frühe Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler wurden aber erst in den 1960er Jahren entwickelt.
=== Schritt 1 - Passiv -> Aktiv ===
Die Mathematikerin Grace Hopper kreirte 1952 den ersten Compiler (A-0). Programmierer reihten ausschließlich Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand und damit Symbolik der Mathematik sowie natürliche Sprache für die Programmierung erschloss. Am 3. Mai 1952 stellte Hopper erstmals öffentlich den ersten Compiler A-0 vor, der Algorithmen aus einem Katalog abrief, Code umschrieb, in passender Sequenz zusammenstellte, Speicherplatz reservierte und die Zuteilung von Speicheradressen organisierte. Anfang 1955 präsentierte Hopper bereits einen Prototyp des Compilers B-0, der nach englischen, französischen oder deutschen Instruktionen Programme erzeugte. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Die jeweils aktuellen Programmiersprachen und Hardwarearchitekturen prägten die Geschichte des Compilerbaus. Weitere frühe Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 2 - Fremdwörter ersetzen ===
Die Mathematikerin Grace Hopper entwickelte 1952 den ersten Compiler (A-0). Programmierer reihten ausschließlich Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand und damit Symbolik der Mathematik sowie natürliche Sprache für die Programmierung erschloss. Am 3. Mai 1952 stellte Hopper erstmals öffentlich den ersten Compiler A-0 vor, der Algorithmen aus einem Katalog abrief, Code umschrieb, in passender Reihenfolge zusammenstellte, Speicherplatz reservierte und die Zuteilung von Speicheradressen organisierte. Anfang 1955 zeigte Hopper bereits einen Prototyp des Compilers B-0, der nach englischen, französischen oder deutschen Anweisungen Programme erzeugte. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Die jeweils aktuellen Programmiersprachen und Hardwarearchitekturen prägten die Geschichte des Compilerbaus. Weitere frühe Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 3 - Kurze Sätze ===
Die Mathematikerin Grace Hopper entwickelte 1952 den ersten Compiler (A-0). Programmierer reihten ausschließlich Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand. Dadurch erschloss sie Symbolik der Mathematik sowie natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper erstmals öffentlich den ersten Compiler A-0 vor, der
* Algorithmen aus einem Katalog abrief
* Code umschrieb
* in passender Reihenfolge zusammenstellte
* Speicherplatz reservierte und
* die Zuteilung von Speicheradressen organisierte.
Anfang 1955 zeigte Hopper bereits einen Prototyp des Compilers B-0. Er erzeugte nach englischen, französischen oder deutschen Anweisungen Programme. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Die jeweils aktuellen Programmiersprachen und Hardwarearchitekturen prägten die Geschichte des Compilerbaus. Weitere frühe Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 4 - Nullwörter & Sätze entfernen ===
Die Mathematikerin Grace Hopper entwickelte 1952 den ersten Compiler (A-0). Programmierer reihten Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand. Dadurch erschloss sie Symbolik der Mathematik sowie natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper den ersten Compiler A-0 öffentlich vor, der
* Algorithmen aus einem Katalog abrief
* Code umschrieb
* in passender Reihenfolge zusammenstellte
* Speicherplatz reservierte und
* die Zuteilung von Speicheradressen organisierte.
Anfang 1955 zeigte Hopper einen Prototyp des Compilers B-0. Er erzeugte nach englischen, französischen oder deutschen Anweisungen Programme. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Weitere frühe Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 5 - Adjektive entfernen ===
Die Mathematikerin Grace Hopper entwickelte 1952 den ersten Compiler (A-0). Programmierer reihten Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand. Dadurch erschloss sie Symbolik der Mathematik sowie natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper den ersten Compiler A-0 öffentlich vor, der
* Algorithmen aus einem Katalog abrief
* Code umschrieb
* in Reihenfolge brachte
* Speicherplatz reservierte und
* die Zuteilung von Speicheradressen organisierte.
Anfang 1955 zeigte Hopper einen Prototyp des Compilers B-0. Er erzeugte nach englischen, französischen oder deutschen Anweisungen Programme. Hopper nannte ihren Talk zum ersten Compiler „The Education of a Computer“.
Weitere Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Features heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 6 - Anglizismen ersetzen ===
Die Mathematikerin Grace Hopper entwickelte 1952 den ersten Compiler (A-0). Programmierer reihten Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand. Dadurch erschloss sie Symbolik der Mathematik sowie natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper den ersten Compiler A-0 öffentlich vor, der
* Algorithmen aus einem Katalog abrief
* Code umschrieb
* in Reihenfolge brachte
* Speicherplatz reservierte und
* die Zuteilung von Speicheradressen organisierte.
Anfang 1955 zeigte Hopper einen Prototyp des Compilers B-0. Er erzeugte nach englischen, französischen oder deutschen Anweisungen Programme. Hopper nannte ihren Vortrag zum ersten Compiler „The Education of a Computer“.
Weitere Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Funktionen heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 7 - Substantivierte Verben ersetzen ===
Die Mathematikerin Grace Hopper entwickelte 1952 den ersten Compiler (A-0). Programmierer reihten Nullen und Einsen aneinander, bis Grace Hopper den Compiler erfand. Dadurch erschloss sie Symbolik der Mathematik sowie natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper den ersten Compiler A-0 öffentlich vor, der
* Algorithmen aus einem Katalog abrief
* Code umschrieb
* in Reihenfolge brachte
* Speicherplatz reservierte und
* Speicheradressen zuteilte.
Anfang 1955 zeigte Hopper einen Prototyp des Compilers B-0. Er erzeugte nach englischen, französischen oder deutschen Anweisungen Programme. Hopper nannte ihren Vortrag zum ersten Compiler „The Education of a Computer“.
Weitere Meilensteine sind 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Funktionen heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
=== Schritt 8 - Alles was mich sonst noch stört ===
Die Mathematikerin Grace Hopper entwickelte 1952 "A-0", den ersten Compiler. Vorher reihten Programmierer Nullen und Einsen aneinander. Durch den Compiler erschloss Hopper Symbolik der Mathematik und natürliche Sprache für die Programmierung. Am 3. Mai 1952 stellte Hopper A-0 in dem Vortrag „The Education of a Computer“ öffentlich vor. A-0 rief Algorithmen aus einem Katalog ab, schrieb Code um und sortierte ihn, reservierte Speicherplatz und teilte Speicheradressen zu.
Anfang 1955 zeigte Hopper einen Prototyp des Compilers B-0. Er erzeugte Programme nach englischen, französischen oder deutschen Anweisungen.
Weitere Meilensteine waren 1957 der erste FORTRAN-Compiler und 1960 der erste COBOL-Compiler. Viele Funktionen heutiger Compiler entwickelten sich aber erst in den 1960er Jahren.
==== Änderungen: ====
* Inhaltlicher Bezug komisch ("Education of a Computer")
* Tempuswechsel ("Weitere Meilensteine sind")
* Deutlicherer Bezug ("erzeugte Programme")
* 2 Doppelmopplung im ersten Absatz
** Erfindung des Compilers
** Bezug A-0


== Text neu schreiben ==


* Gliederung - Was will ich eigentlich sagen?
** Wer ist mein Publikum?
** Witzigkeit! (Witzige Beispiele)
* Satzfetzen, Links, copy+paste
* Ausformulieren - grob
** Ersten Absatz streichen
* Pro Paragraph ein Gedanke -> rumschieben
* Feinschliff:


Mögliche Übungsaufgaben: Wie entstand die Brony-Bewegung; Geschichte Deiner Lieblingsprogrammiersprache; ...
[[Verständlich Schreiben/Übungen|Spoiler]]

Latest revision as of 18:32, 13 April 2013

Verständlich Schreiben
OpenChaos April 2013
Art Workshop
Datum 2013-04-13
Start 15:00
Dauer 3h
Speaker pallas
Host nomaster

Dieser Vorschlag für OpenChaos war bereits einmal gebucht. Die Veranstaltung ist jedoch ausgefallen.

Links[edit | edit source]


Ankündigungstext[edit | edit source]

Wir alle freuen uns über gute Doku, wenn wir etwas Neues lernen. Doch wie sieht es mit der Doku für unsere eigenen Projekte aus? Ist sie a) vorhanden und b) verständlich geschrieben?

Gut zu schreiben kann man lernen. Im Workshop verbessern wir "fertige" Texte in mehreren Schritten. Bring also gerne Deine vorhandenen Texte mit! Es muss auch nicht unbedingt eine Dokumentation sein, da die meisten Regeln für alle Arten von Text gelten. Für alle die noch keine Texte haben bringt Corinna Übungstexte mit.

Das Überarbeiten geht am besten mit einem Laptop. Alternativ kannst Du auf totem Baum mitmachen.

Der Workshop orientiert sich an diesem Artikel von Su-Shee



Spoiler