search

importPI19fromDHGE / dhge-pi19-sem3

Mitschriften des Matrikel 2019, aus dem dritten Semester des Studiengangs "Praktische Informatik", an der DHGE
14 stars 8 forks source link

Klare Ordnerstruktur für Module definieren #89

Open Steve2955 opened 3 years ago

Steve2955 commented 3 years ago

Ich würde gerne eine einheitliche Struktur für Module definieren. Was sich momentan als Standard etabliert hat sieht wie folgt aus:

Modul/
├── resources/ - Bilder
│   ├── imgA.png
│   ├── imgB.png
│   └── imgB.svg
└── README.md - Modulmitschriften

Wie wollen wir darin folgende Dokumente unterbringen:

Eventuell könnten wir dann auch ein paar Automatismen entwickeln, die für die PDFs die zusätzliche Files in einen Anhang packen.

Was mir noch aufgefallen ist, ist das in diesem Repo noch aus Zeiten indem es nur privat zugänglich war, noch das Skript von DBS liegt. Ich denke wir sollten das entfernen.

Steve2955 commented 3 years ago

Eine weitere wichtige Frage wäre, ob wir zukünftige Semester auch in diesem Repository verwalten wollen oder ob wir dafür getrennte Repos erstellen?

RvNovae commented 3 years ago

Eine weitere wichtige Frage wäre, ob wir zukünftige Semester auch in diesem Repository verwalten wollen oder ob wir dafür getrennte Repos erstellen?

Der Übersicht halber (und weil der Name des Repos es ja suggeriert) wäre es wahrscheinlich die zu trennen. Blöd ist nur, dass man dann die ganzen Actions übernehmen müsste. Man könnte aber vielleicht ein Template-Repo basteln, auf dem man dann jedes neues Semester basieren kann. Nur so als Idee 😄

Steve2955 commented 3 years ago

Den Namen dieses Repos könnten wir auch ohne Probleme ändern. @ZeroPointMax Welche Option würdest du bevorzugen?

  1. alle Semester in eine Repo zusammenfassen
  2. jedes Semester in eigenem Repo
  3. jedes Semester in eigenem Repo und als Submodules nochmal in eine Repo zusammenfassen
  4. weitere Vorschläge?
Steve2955 commented 3 years ago

Was würden wir eigentlich mit Modulen machen, die über mehrere Semester gehen oder Module wie INV, die diese komische Zweiteilung haben 😅

Steve2955 commented 3 years ago

@ZeroPointMax @RvNovae Hier mal ein Vorschlag als Diskussionsgrundlage:

<Semester>/
├── <Modul>/
│   ├── additional/         <- Anhang: Praktika, Übungen, ...
│   │   ├── <Praktika>.md
│   │   ├── <Cheatsheet>.md
│   │   └── <Übung>.md
│   ├── extra/              <- Zusätzliches: Vorträge, ...
│   │   └── <Vortag>.pdf
│   ├── figures/            <- Bilder (können auch bei resources bleiben)
│   │   ├── <filename>.png
│   │   ├── <filename>.png
│   │   └── <filename>.svg
│   └── README.md           <- Modulmitschriften
└── README.md 

<Semester> ::= SEMESTER-{1|2|3|4|5|6}

<Modul> ::= <Kürzel>-<Dozent>
<Kürzel> ::= {RES|ALGO|INV|DBS|NET|...}
<Dozent> ::= {DORENDORF|KUSCHE|KASCHE|GUENTHER|FELDMANN|...}

<filename> :: <zeichen><filename> | <zeichen>
<zeichen> ::= a..z | 0..9 | -
^^kebab-case
ZeroPointMax commented 3 years ago

Den Namen dieses Repos könnten wir auch ohne Probleme ändern. @ZeroPointMax Welche Option würdest du bevorzugen?

  1. alle Semester in eine Repo zusammenfassen
  2. jedes Semester in eigenem Repo
  3. jedes Semester in eigenem Repo und als Submodules nochmal in eine Repo zusammenfassen
  4. weitere Vorschläge?

Ich wäre für 2, ggf. mit Template

ZeroPointMax commented 3 years ago

@Steve2955 @RvNovae

bzgl. Diskussionsgrundlage: (ich komme zum Punkt, schönes Reden ist in einer Kasche-VL zu anstrengend ;) )

Steve2955 commented 3 years ago
  • wenn wir resources in figures umbenennen und wir haben Gott-weiß-welche Sachen, die wir verlinken wollen, wo kommen die dann hin?

Was genau meinst du damit? Bisher sind in den resources-Verzeichnissen nur Bilder. Mich würde es jetzt nicht stören wenn da 100+ oder mehr Bilder drin sind solange diese ordentlich benannt sind.

ZeroPointMax commented 3 years ago
  • wenn wir resources in figures umbenennen und wir haben Gott-weiß-welche Sachen, die wir verlinken wollen, wo kommen die dann hin?

Was genau meinst du damit? Bisher sind in den resources-Verzeichnissen nur Bilder. Mich würde es jetzt nicht stören wenn da 100+ oder mehr Bilder drin sind solange diese ordentlich benannt sind.

Für den Fall, das mal was anderes als Bilder reinkommt meine ich. Wüsste jetzt aber auch nicht, was das wäre

RvNovae commented 3 years ago

Nennen wir es doch einfach assets oder so 😉

Steve2955 commented 3 years ago
  • die Aufteilung in extraund additional finde ich von der Intention gut, aber die Namen würde ich anders wählen, damit man sie besser unterscheiden kann. Bzw. @Steve2955 kannst du die Aufteilung bitte nochmal verbosiger beschreiben, was deine Gedanken dahinter sind?

@ZeroPointMax extra und additional können wir gerne umbenennen, da bin ich für Vorschläge offen.

Die Idee hinter additional ist alles zusammenzufassen, was keine Vorlesungsmitschrift ist, aber eigentlich mit dazu gehört. Also z.B. die Praxisübungen, die wir in NET machen oder das Praktikum zu DBS.

extra soll Sachen zusammenfassen die zusätzlich zu den Vorlesungsmitschriften und additional existieren, wie z.B. die Vorträge in RES. Die Vorbereitung der Vorträge kann da gerne auch noch mit rein. Solche Sachen werden in der Regel in den Mitschriften/additional kurz zusammengesfasst (wie im Fall von RES) oder habe an sich keine Bedeutung für Klausuren und sind rein zusätzliche optionale Infos.

So hätte ich mir das in etwa vorgestellt 🤔

Steve2955 commented 3 years ago
  • ich mag keine Monolithen, daher wäre ich für separate Repos pro Semester ;)

Module über mehrere Semester sind dann im Semester in dem sie beginnen oder aufgeteilt?

ZeroPointMax commented 3 years ago
  • ich mag keine Monolithen, daher wäre ich für separate Repos pro Semester ;)

Module über mehrere Semester sind dann im Semester in dem sie beginnen oder aufgeteilt?

aufgeteilt

ZeroPointMax commented 3 years ago
  • die Aufteilung in extraund additional finde ich von der Intention gut, aber die Namen würde ich anders wählen, damit man sie besser unterscheiden kann. Bzw. @Steve2955 kannst du die Aufteilung bitte nochmal verbosiger beschreiben, was deine Gedanken dahinter sind?

@ZeroPointMax extra und additional können wir gerne umbenennen, da bin ich für Vorschläge offen.

Die Idee hinter additional ist alles zusammenzufassen, was keine Vorlesungsmitschrift ist, aber eigentlich mit dazu gehört. Also z.B. die Praxisübungen, die wir in NET machen oder das Praktikum zu DBS.

extra soll Sachen zusammenfassen die zusätzlich zu den Vorlesungsmitschriften und additional existieren, wie z.B. die Vorträge in RES. Die Vorbereitung der Vorträge kann da gerne auch noch mit rein. Solche Sachen werden in der Regel in den Mitschriften/additional kurz zusammengesfasst (wie im Fall von RES) oder habe an sich keine Bedeutung für Klausuren und sind rein zusätzliche optionale Infos.

So hätte ich mir das in etwa vorgestellt 🤔

Ahja, da wäre ich voll dafür. Ich sehe lediglich das Problem, dass ich mir nicht merken kann, was in additional und was in extra gehört, weil das fast-Synonyme in meinem Gehirn sind

RvNovae commented 3 years ago
  • die Aufteilung in extraund additional finde ich von der Intention gut, aber die Namen würde ich anders wählen, damit man sie besser unterscheiden kann. Bzw. @Steve2955 kannst du die Aufteilung bitte nochmal verbosiger beschreiben, was deine Gedanken dahinter sind?

@ZeroPointMax extra und additional können wir gerne umbenennen, da bin ich für Vorschläge offen. Die Idee hinter additional ist alles zusammenzufassen, was keine Vorlesungsmitschrift ist, aber eigentlich mit dazu gehört. Also z.B. die Praxisübungen, die wir in NET machen oder das Praktikum zu DBS. extra soll Sachen zusammenfassen die zusätzlich zu den Vorlesungsmitschriften und additional existieren, wie z.B. die Vorträge in RES. Die Vorbereitung der Vorträge kann da gerne auch noch mit rein. Solche Sachen werden in der Regel in den Mitschriften/additional kurz zusammengesfasst (wie im Fall von RES) oder habe an sich keine Bedeutung für Klausuren und sind rein zusätzliche optionale Infos. So hätte ich mir das in etwa vorgestellt 🤔

Ahja, da wäre ich voll dafür. Ich sehe lediglich das Problem, dass ich mir nicht merken kann, was in additional und was in extra gehört, weil das fast-Synonyme in meinem Gehirn sind

Vielleicht assets und extra / additional? Das sollte etwas weniger verwirrend sein, da assets ja kein Wort ist, das was zusätzliches ausdrückt

ZeroPointMax commented 3 years ago

@RvNovae aber andererseits wollten wir das ja als Ersatz für resources nehmen

RvNovae commented 3 years ago

@RvNovae aber andererseits wollten wir das ja als Ersatz für resources nehmen

Passt da assets nicht wunderbar? 🤔

Steve2955 commented 3 years ago

@RvNovae aber andererseits wollten wir das ja als Ersatz für resources nehmen

Passt da assets nicht wunderbar? 🤔

Ja genau, uns geht es eigentlich darum, dass sich extra und additional semantisch nicht stark genug abgrenzen.

RvNovae commented 3 years ago

@RvNovae aber andererseits wollten wir das ja als Ersatz für resources nehmen

Passt da assets nicht wunderbar? 🤔

Ja genau, uns geht es eigentlich darum, dass sich extra und additional semantisch nicht stark genug abgrenzen.

Deswegen schlage ich ja assets vor? Ich glaube wir reden aneinander vorbei 😅

Steve2955 commented 3 years ago

@RvNovae aber andererseits wollten wir das ja als Ersatz für resources nehmen

Passt da assets nicht wunderbar? 🤔

Ja genau, uns geht es eigentlich darum, dass sich extra und additional semantisch nicht stark genug abgrenzen.

Deswegen schlage ich ja assets vor? Ich glaube wir reden aneinander vorbei 😅

Wir dachten assets statt figures 😂

RvNovae commented 3 years ago

@RvNovae aber andererseits wollten wir das ja als Ersatz für resources nehmen

Passt da assets nicht wunderbar? 🤔

Ja genau, uns geht es eigentlich darum, dass sich extra und additional semantisch nicht stark genug abgrenzen.

Deswegen schlage ich ja assets vor? Ich glaube wir reden aneinander vorbei 😅

Wir dachten assets statt figures 😂

Ahhhhh, ich glaub ich hab einfach nicht genau gelesen. Passt, das war einfach nur allgemeine Verwirrung auf meiner Seite 😂

Steve2955 commented 3 years ago

@RvNovae @ZeroPointMax Was ich noch vorschlagen würde ist statt additional einfach appendix zu verwenden:

<Modul>/
├── appendix/           <- Anhang: Praktika, Übungen, ...
│   ├── <Praktika>.md
│   ├── <Cheatsheet>.md
│   └── <Übung>.md
├── extra/              <- Zusätzliches: Vorträge, ...
│   └── <Vortag>.pdf
├── assets/             <- Bilder
│   ├── <filename>.png
│   ├── <filename>.png
│   └── <filename>.svg
└── README.md           <- Modulmitschriften

<Modul> ::= <Kürzel>-<Dozent>
<Kürzel> ::= {RES|ALGO|INV|DBS|NET|...}
<Dozent> ::= {DORENDORF|KUSCHE|KASCHE|GUENTHER|FELDMANN|...}

<filename> :: <zeichen><filename> | <zeichen>
<zeichen> ::= a..z | 0..9 | -
^^kebab-case
RvNovae commented 3 years ago

Klingt gut!