-
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 5 #14
base: main
Are you sure you want to change the base?
Conversation
Build Successful! You can find a link to the downloadable artifacts below.
|
* Erstes Teilziel | ||
* Zweites Unterthema | ||
* Dritter Aspekt | ||
Teilnehmer:innen verstehen den Nutzen von API-Beschreibungen und kennen die Zielgruppen. Das Problem des "API Drift" ist bekannt. Sie können das Zusammenspiel von Design, Implementierung, Versionierung, Beschreibung, Versionierung der Beschreibung einordnen und wie diese Dinge im Idealfall sowie in der Realität praktiziert werden. |
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.
API-Beschreibung besser ohne Bindestrich?
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.
Gleiches Thema wie bei "API Design" vs "API-Design". Ich glaube, in "API-Beschreibung" muss ein Bindestrich hin, weil "Beschreibung" ein deutsches Wort ist. Und bei "API Drift" muss keiner hin, weil "Drift" ein englisches Wort ist. Aber 100% sicher bin ich mir nicht.
In jedem Fall sollte die Schreibweise aber in Überschrift und Textblock einheitlich sein.
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.
Mein Gefühl für Deutsch ist etwas angeschlagen, wahrscheinlich von englischer Grammatik. Ich finde die deutschen Bindestrich-Exzesse wenig hilfreich, aber der Duden mag da anderes denken.
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.
Some minor comments.
|
||
Teilnehmer:innen verstehen OpenAPI als eine auf HTTP APIs spezialisierte Beschreibungssprache. | ||
Sie kennen die Geschichte von OpenAPI und wie sich die verschiedenen Versionen entwickelt haben. | ||
Teilnehmer:innen wissen, wie sich OpenAPI zur Codegenerierung auf der Anbieter- oder Konsumentenseite verwenden lässt. |
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.
Codegenerierung oder Code-Generierung?
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.
Ich wäre für ohne Bindestrich.
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.
Bitte Kommentare berücksichtigen, ansonsten approved.
No description provided.