Zum Inhalt springen
View in the app

A better way to browse. Learn more.

Fachinformatiker.de

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Erklärungen in der Projektdokumentation

Empfohlene Antworten

Veröffentlicht

Hallo,

ich hätte eine Frage zu Erklärungen von Technologien in der Projektdokumentation.
Sollten Erklärungen zu gewissen Technologien in den Anhang oder mit in den Fließtext ?
Beispiel hier eine Erklärung zum virtual DOM von React.

Zitat

[...]React nutzt zum Ändern der Elemente auf der Website ein virtuelles DOM, was bedeutet, dass im Hintergrund eine Kopie des eigentlichen DOMs vorliegt. Sobald Änderungen an einem Element z.B. durch Interaktion eines Benutzers entstehen, wird das komplette virtuelle DOM geupdated. Dieses erneuerte virtuelle DOM wird mit einem Snapshot vor der Änderung verglichen. Dieses Verfahren nennt sich „diffing“. Sobald die Änderungen erkannt worden sind, wird das richtige DOM geupdated und zwar nur die Elemente, welche auch wirklich verändert wurden[...]

Es gibt noch ein Paar weitere Erklärungen in der Doku die ähnlich wie diese Ablaufen.

Danke schon mal für eure Hilfe

Bearbeitet von StoneCodes

Wenn du es im Detail erklären kannst, falls dich jemand fragt und es für das Verständnis relevant ist, dann nimm es mit rein. Ansonsten lass es raus. Deine Projektdokumentation soll nicht für Programmierer ausgelegt sein.

Ich würde es in den Anhang packen, ja. Ggf. in dein Glossar.

vor 5 Stunden schrieb StoneCodes:

Hallo,

ich hätte eine Frage zu Erklärungen von Technologien in der Projektdokumentation.
Sollten Erklärungen zu gewissen Technologien in den Anhang oder mit in den Fließtext ?
Beispiel hier eine Erklärung zum virtual DOM von React.

Es gibt noch ein Paar weitere Erklärungen in der Doku die ähnlich wie diese Ablaufen.

Danke schon mal für eure Hilfe

Zwei Anmerkungen:

- Wenn du Begriffe wie DOM verwenden willst, brauchst du ein Glossar. 

- Mit denglischen Wörtern wie geupdatet wäre ich vorsichtig. "Aktualisiert" wäre hier wohl besser.

vor einer Stunde schrieb StoneCodes:

Glossar ist vorhanden, das mit den englischen wörtern überdenk ich nochmal. Mir erschien die Erklärung hier nur zu groß für den glossar

Nur, damit wir uns richtig verstehen: Die Erklärung kommt natürlich nicht in das Glossar ?

Erstelle ein Konto oder melde dich an, um einen Kommentar zu schreiben.

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.