Skip to content

Commit

Permalink
glossar
Browse files Browse the repository at this point in the history
  • Loading branch information
johannesloetzsch committed Dec 7, 2024
1 parent fcb0d8f commit cd8f4a8
Show file tree
Hide file tree
Showing 4 changed files with 37 additions and 4 deletions.
32 changes: 32 additions & 0 deletions 80_Glossar/glossar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Glossar

## workingname „Schulstick“ -> braucht noch einen Name

* gibt viel andere tolle Varianten / Usecases als nur „Schule“ ([`usb-live-linux` variants](https://github.com/fsfw-dresden/usb-live-linux/tree/main/variants.build))

### ~~Lernstick~~

* sagt aus was es ist
* aber ist [etabliere Marke aus der Schweiz](https://www.bfh.ch/de/forschung/forschungsbereiche/lernstick/). Wir wollen keine Konkurenz sein und Konflikte vermeiden.


## „Kurse“

* Begriff auf den wir uns geeinigt haben.
* Begriff, wie ihn auch Liascript verwendet

### „Tutorial“, „Lerninhalte“, „Lernpakete“

* Ist als Synonym erlaubt
* Aber als bei Verwendung immer klar machen, dass es sich um „Kurse“ handelt


## „Lektionen“

* Sind die Bestandteile von „Kursen”

> Frage: Wie mappt das auf Ordner und einzelne *.md?
### Im Code derzeit „Unit“ genannt

* sehr mehrdeutiger Name. Aber was wäre besser?
6 changes: 2 additions & 4 deletions 99_wip_spec/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,8 @@ title: Bereitstellen neuer Tutorials für den Schulstick
<!-- TODO: Ist der titel erforderlich? welche anderen metadaten sind erwünscht? wo ist das spezifiziert? -->
<!-- TODO: (Warum) ist metadata.yml (in späterer zukunft) erforderlich/sinnvoll, statt die metadaten direkt in den markdown-metadaten zu speichern? -->

<!-- TODO: gibt es ein glosar für das wording das wir im kontext des schulsticks verwenden?
* „Kurse“ anstatt „Tutorial“, „Lerninhalte“, „Lernpakete“ — Der Begriff wie ihn auch Liascript verwendet
* Diese enthalten „Lektionen“ — Frage: Wie mappt das auf Ordner und einzelne *.md?
* generischer Name für (Schul-)Stick (aka [`usb-live-linux` variants](https://github.com/fsfw-dresden/usb-live-linux/tree/main/variants.build))
<!-- TODO: gibt es ein glossar für das wording das wir im kontext des schulsticks verwenden?
Antwort: Ja, jetzt gibt es ihn: https://fsfw-dresden.github.io/schulstick-tutorial-docs/80_Glossar/glossar.html
-->

# Schulstick Tutorials
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,3 +33,5 @@ flowchart TD
```

* Um den Quickstart als Grundlage für die Umsetzung entsprechend umsetzen zu können, Enthällt dieses Repo auch eine Formulierung unserer [Ziele](./01_Ziel/ziel.md) und [Versprechen](./02_Claim/claim.md)

* Um einheitliche Begriffe (und vielleicht einprägsamme „Markennamen“) zu haben, wird ein [Glossar](80_Glossar/glossar.md) erstellt.
1 change: 1 addition & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,5 @@
* [Ziele](./01_Ziel/ziel.md)
* [Claim](./02_Claim/claim.md)
* [Quickstart](10_Quickstart/quickstart.md)
* [Glossar](80_Glossar/glossar.md)
* [WIP spec](99_wip_spec/intro.md)

0 comments on commit cd8f4a8

Please sign in to comment.