Wiki-Artikel schreiben

Zielsetzung der Artikel

Das Ziel ist die nachhaltige Sicherung von Informationen. D. h. die Artikel sollen so geschrieben sein, dass jemand die Erkenntnisse leicht verwenden kann und z. B. realisierte Projekte nachbauen kann! Es gilt: „Inhalt vor Schönheit“ bei Einhaltung des wissenschaftlichen Standards für Dokumentationen.

Aufbau der Artikel

Sie dürfen die Vorlage für Wiki-Artikel Wiki-Artikel_Vorlage als Grundlage verwenden. Der Aufbau ist wie folgt:

1. Einleitung
   • inkl. Nennung der Autoren
   • Beschreibung des organisatorischen Rahmens (Praktikum? Lehrveranstaltung?), in dem dieser Artikel entsteht.
   • Fügen Sie einen Link ein, der zu dem organisatorischen Rahmen des Projekts zurückführt (z. B. zu einer Übersichtsseite einer Lehrveranstaltung)
2. Inhalt, gegliedert je nach Sinn & Zweck
   • Arbeiten Sie Ihre wesentlichen Erkenntnis bei Ihrem Projekt heraus. Was haben Sie gelernt?
   • Schritt-für-Schritt-Anleitungen (Quellcode, Bilder, Problemlösungen, Kochrezepte,…)
   • Details wie
     • Bill of Material (BOM)
     • ggf. Programmablaufpläne
     • z. B. bei Regler-Themen: Herleitung der verwendeten Regelstrecke und des Reglers
     • z. B. Bei Sensor-Themen: Berechnung der Güte der Sensoren nach den bekannten Methoden der Messtechnik
3. Fazit/Zusammenfassung/Ausblick
   • Was ist das Ergbnis?
   • Was kann/muss noch verbessert werden?
   • Fügen Sie einen Link ein, der zu dem organisatorischen Rahmen des Projekts zurückführt (z. B. zu einer Übersichtsseite einer Lehrveranstaltung)
4. Quellen: Sobald Sie eine Quelle (insbesondere bei Bildern) verwenden, nennen Sie diese.
5. Korrektur/Rückmeldungen

Regeln für das Verfassen von Artikeln

Bitte beachten Sie beim Verfassen von Artikeln in diesem Wiki unbedingt die folgenden Hinweise! Tipp: Nach Verfassen des Artikels kontrollieren Sie noch einmal diesen und nutzen die folgende Liste als "Checkliste".

1. Ganz zu Beginn und am Ende des Artikels ist ein Link auf die Seite zu erstellen, der diesen Artikel auflistet (um dort wieder leicht zurück zu kommen).
2. temporäre Dateien wie z. B. Projektpläne etc. gehören nicht ins Wiki!
3. Bilder:
   • Auf Bilder verweisen
4. Bildunterschrift aussagekräftig und inkl. Quellenangabe?
   • Bei jedem Bild sind die Originaldaten hinzuzufügen, mit denen das Bild erstellt wurde, damit künftige Erweiterungen/Nachbesserungen etc. ermöglicht werden (Bsp: Zeichnung: Bild der Zeichnung als *.jpg und die Ursprungsdatei als *.ppt o. ä. ablegen!)
   • Nutzen Sie die Bilder ausführlich für Erklärungen, z. B. indem Sie mit Hilfe von Ziffern o. ä. Markierungen im Bild verwenden!
   • Platzieren Sie Ihre Bilder übersichtlich und in einer ansprechenden Größe
5. Nutzen Sie Verknüpfungen (insbes. zu internen Artikeln) und helfen Sie mit diese zu verbessern, indem Sie die für Ihren Artikel notwendigen Infos dort mit einbringen.
6. Quellen angeben (insbesondere bei Bildern etc.)
7. Nutzen Sie Aufzählungen/Tabellen/Formeln, um Ihren Text leicht lesbar zu machen.
8. Vermeiden Sie langen Fließtext.
9. Beschreiben Sie alles so, dass jemand mit Ihren Erkenntnissen das Projekt aufgreifen, erweitern, modifizieren, benutzen etc. kann.
10. Schreiben Sie den Artikel wie eine wissenschaftliche Arbeit. Hilfreich dazu ist dieses Buch . Auch empfiehlt sich der Blick ein beispielhafte wissenschaftliche Arbeiten, z. B.: Datei:Skript Fahrwerkmanagent ProfGöbel.pdf
11. Hängen Sie alle notwendigen Daten zum "Nachbau" Ihres Fachthemas als zip-Datei an Ihren Wiki-Artikel.
12. Rechtschreibung! Prüfen Sie Ihren Artikel sorgfältig (ggf. mit Hilfe einer Textverarbeitungs-Software)
13. Fügen Sie Ihrem Artikel eine zip-Datei mit allen wichtigen Dateien zum Nachbau Ihres Projekts hinzu:
    • Präsentation (.ppt und .pdf)
    • Für Lego Roboter - Anleitung zum Nachbau (Lego Designer .ldx und .html)
    • ggf. Platinenlayout, Schaltungssimulation, Circuit-Cam, Boardmaster-Originaldateien
    • ggf. Software/Implementierung