-
Notifications
You must be signed in to change notification settings - Fork 0
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
initial version of chapter 6 #15
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,29 +1,20 @@ | ||
// tag::DE[] | ||
|=== | ||
| Dauer: XXX Min. | Übungszeit: XXX Min. | ||
| Dauer: 90 Min. | Übungszeit: 60 Min. | ||
|=== | ||
|
||
=== Begriffe und Konzepte | ||
Begriff 1, Begriff 2, Begriff 3 | ||
|
||
API Lifecycle, API Produkt, Linting, Consumer-driven Contract Testing, API Gateway | ||
|
||
// end::DE[] | ||
|
||
// tag::EN[] | ||
|=== | ||
| Duration: XXX min | Practice time: XXX min | ||
| Duration: 90 min | Practice time: 60 min | ||
|=== | ||
|
||
=== Terms and Principles | ||
Term 1, Term 2, Term 3 | ||
|
||
// end::EN[] | ||
|
||
[NOTE] | ||
==== | ||
Überschrift in 00-structure.adoc ersetzen | ||
==== | ||
|
||
[NOTE] | ||
==== | ||
Sinnvolle Zeiten für Dauer und Übungszeit eintragen, vernünftige Begriffe aufzählen. | ||
==== |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,34 +1,34 @@ | ||
=== {learning-goals} | ||
|
||
|
||
// tag::DE[] | ||
[[LZ-5-1]] | ||
==== LZ 5-1: Dies ist das erste Lernziel in Kapitel 5, lorem ipsum sit dolor | ||
[[LZ-6-1]] | ||
==== LZ 6-1: API Lifecycle verstehen | ||
|
||
Hier wird beschrieben, was Teilnehmer:innen in diesem Lernziel lernen sollen. Das kann in Prosa-Text | ||
in ganzen Sätzen oder in Aufzählungen mit Unterpunkten erfolgen. Dabei kann auch unterschieden werden, | ||
wie wichtig einzelne Aspekte des Lernziels sind. Es kann hier bereits auf Literatur verwiesen werden. | ||
Teilnehmer:innen kennen verschiedene Schritte des Entwicklungszyklus eines API Produkts und die typischen Aufgaben, die bei diesen Schritten anfallen. | ||
Die Aufteilung in Planung und Anforderungsanalyse, Design und Prototyping, Entwicklung, Testing und Qualitätsprüfung, Deployment und Veröffentlichung, Betrieb und Wartung sowie Verbesserung und Iteration sind bekannt. | ||
Ebenfalls bekannt sind die verschiedenen Lebensphasen eines APIs wie Prototyp, produktiver Betrieb, Deprecation und das Abschalten. | ||
|
||
* Erstes Teilziel | ||
* Zweites Unterthema | ||
* Dritter Aspekt | ||
[[LZ-6-2]] | ||
==== LZ 6-2: APIs als Produkte verwalten | ||
|
||
APIs kommen oft in lose gekoppelten Szenarien zum Einsatz und aus diesem Grund ist es sinnvoll, sie als Produkte zu managen. | ||
Teilnehmer:innen verstehen, was es bedeutet, eine API als Produkt zu verwalten. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. eine -> ein There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Kann ich ändern. Gibt es bei API eine offizielle Meinung zu ein/eine? Ich nehme ich "eine" als eine Schnittstelle. Aber ein Interface ist vermutlich passender. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ein schätze, wir müssen unter uns abstimmen oder beim Council nachfragen :-) There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Gibt es da Kulturkampfdiskussionen? Das sollten wir vermeiden, da werde ich dann sehr schnell sehr flexibel. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ich würde auch "ein" sagen, denn es ist das Interface, das API. Es gibt aber keine Vorgabe oder ähnliches. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Und tatsächlich verwenden alle Quellen, die ich auf die Schnelle finde, "API-Design" als Schreibweise. Also mit Bindestrich. |
||
Dies beginnt beim Zielgruppenfokus, berücksichtigt Fragen der Nutzbarkeit, von Feedback sowie Verbesserung und behandelt auch Fragen von Deprecation und der Bereitstellung von Alternativen. | ||
|
||
[[LZ-6-3]] | ||
==== LZ 6-3: API Lifecycle Tooling kennen | ||
|
||
Teilnehmer:innen kennen typische Tools für den Einsatz im API Lifecycle zur Unterstützung von Produzenten und Konsumenten wie Linting, Testing (z. B. Consumer-driven Contract Testing), Mocking sowie Betrieb (API Gateways). | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Wie oben vorgeschlagen "Consumer-driven" loeschen? |
||
Teilnehmer:innen können mit einigen dieser Tools praktisch arbeiten und verstehen sie in das Gesamtbild des API Lifecycle Tooling einzuordnen. | ||
|
||
[[LZ-5-2]] | ||
==== LZ 5-2: Hier ist ein zweites Lernziel in diesem Kapitel | ||
tbd. | ||
// end::DE[] | ||
|
||
// tag::EN[] | ||
[[LG-5-1]] | ||
==== LG 5-1: TBD | ||
[[LG-6-1]] | ||
==== LG 6-1: TBD | ||
tbd. | ||
|
||
[[LG-5-2]] | ||
==== LG 5-2: TBD | ||
[[LG-6-2]] | ||
==== LG 6-2: TBD | ||
tbd. | ||
// end::EN[] | ||
|
||
[NOTE] | ||
==== | ||
Die einzelnen Lernziele müssen nicht als einfache Aufzählungen mit Unterpunkten aufgeführt werden, sondern können auch gerne in ganzen Sätzen formuliert werden, welche die einzelnen Punkte (sofern möglich) integrieren. | ||
==== |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sollen wir "Consumer-driven" rausschmeissen und einfach nur "Contract Testing"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oder vielleicht "Consumer-driven" in Klammern?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok, wenn das hilft auch gut. Je weniger wir uns festlegen auf spezielle Nischen desto besser.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ja, finde ich gut. Passe ich noch an.