digiwf-core icon indicating copy to clipboard operation
digiwf-core copied to clipboard

Template Readme

Open markostreich opened this issue 1 year ago • 2 comments

Is your feature request related to a problem? Please describe.

Als Entwickler möchte ich eine einheitliche Readme für alle Komponenten für einen schnellen Überblick über die Beschreibung der Komponente und ihre Parameter nutzen können, um mich schneller zurecht zu finden.

Describe the solution you'd like

Für eine Integration wird eine Readme beispielhaft erstellt, die an Blaupause für alle weiteren Komponenten (Integrationnen und Services) genutzt werden kann. Die Readme enthalt eine Beschreibung der Komponente und der Konfigurationsparameter. Bei Integrationen ist besonders darauf zu achten, dass technische Informationen aus https://digiwf.oss.muenchen.de/integrations/ in die Readme verschoben und Modellierungs-Informationen in die Modellierungs-Doku mit dem ebenfalls erstellen Templates verschoben werden.

Describe alternatives you've considered

Es wird ein separates Template mit Beispielinhalten erstellt.

Acceptance Criteria

  • [ ] Eine Dokumentation liegt an einer Komponente vor.
  • [ ] Für die Integration existiert im Modellierungs-Teil der öffentlichen Dokumentation ein Eintrag entsprechend des zugehörigen Templates

Additional context

markostreich avatar Feb 29 '24 10:02 markostreich

Evtl kann auch direkt das Beispiel https://github.com/it-at-m/digiwf-cocreation/blob/47238746bd7e5ee90d26773f18ebaf37a9075ba5/digiwf-cocreation-deployment-service/README.md genutzt werden

simonhir avatar Mar 01 '24 09:03 simonhir

Hey team! Please add your planning poker estimate with Zenhub @darenegade @lehju @simonhir

markostreich avatar Mar 01 '24 09:03 markostreich

Only service README is updated. Existing integration docs in open source documentation stay at is except move of configuration in README.

simonhir avatar Jul 03 '24 12:07 simonhir