Spezielle Gebiete zum Software Engineering Script

Dies ist das gemeinsam erstellte Modul Script zu den Themen, die im Sommersemester 2017 an der FH-Bielefeld im Modul behandelt wurden.

Anleitung:

• die Texte werden mit Mardown erstellt

• pro Kapitel wird eine Datei erstellt und nicht eine Datei pro Person

• pro Buch existiert eine Datei, in der die wichtigsten Eckdaten stehen und evtl. eine kleine Einleitung oder Zusammenfassung

• daraus ergibt sich folgende Struktur pro Buch:

  • buchname.md
  • buchname (Ordner)
  • buchname/kapitelnummer_kapitelname.vorname_nachname
  • Beispiel:
    • co-economy_wertschoepfung_im_digitalen_zeitalter.md
    • co-economy_wertschoepfung_im_digitalen_zeitalter (Ordner)
    • co-economy_wertschoepfung_im_digitalen_zeitalter/1_connectedness.fabian_lorenz.md
    • co-economy_wertschoepfung_im_digitalen_zeitalter/2_colaboration.fabian_lorenz.md
    • co-economy_wertschoepfung_im_digitalen_zeitalter/3_cases.lutz_winkelmann.md
    • ...
  • assets/bildname.png (o. *.jpg ...) (Bildordner)

• um das ganze einheitlich zu gestallten folgende Formatierung innerhalb der Kapitel:

  • Kapitelüberschrift in H1 (z. B. # 3 Cases)
  • Unterkapitel in H2 (z. B. ## 3.1 Die neue Sharing Economy)
  • Abschnittsüberschriften in H3 (z. B. ### Technologien und Innovationen)
  • Bilder einfügen (z. B. ![Alternativer Bildtext] (/assets/bildname.png) (Abbildung 1: Bildbeschriftung))

• es wird nur noch mit Github gearbeitet und nicht mehr auf dem GitBook direkt

• jeder arbeitet auf einem eigenen Branch (z. B. "florenz" und nicht master branch)

• dieser wird per pull request an github geschickt und vom Admin gemerget bzw. mit Kommentar abgelehnt, falls etwas nicht passt

• auf gitbook kann man sich die aktuelle Version ansehen (sobald der merge durchgeführt wurde)
  https://www.gitbook.com/book/fh-bielefeld-mif-sw-engineerin/script/details

• um die Seitenzahl herauszufinden, falls jemand einen Markdown Editor verwendet, der das Dokument nicht als PDF anzeigen:

  • im Chrome-Browser rechte Maustaste
  • Drucken
  • nach PDF exportieren

• Termin: Monday 12 Jun 2017 Inhaltliche Struktur des eigenes Themas im Gitbook (10:30 Uhr)

  • aktuelle Version vom Masterbranche holen
  • in die Datei summary.md im unteren Bereich "Projekte" die Struktur des Projektes nach folgendem Schema kopieren und Pull Request senden:
    • Projektname (z. B. Fullstack Development)
      • individuelles Thema Student1 (z. B. NoSQL)
        • Unterkapitel1 (z. B. Einführung)
        • Unterkapitel2 (z. B. ObjektbassierteDB)
        • Unterkapitel3 (z. B. DokumentbasierteDB)
        • ...
      • individuelles Thema Student2
        • ...
  • am besten macht dies einer pro Gruppe, da alle in die selbe datei schreiben müssen, um Konflikte zu vermeiden