Correcting some Typos in lang/de - #159
Open
vedam wants to merge 3 commits into
Open
Conversation
developit
approved these changes
Sep 8, 2017
Member
|
Looks good to me! Maybe we can get @ShalokShalom to review it as well :) |
ShalokShalom
suggested changes
Sep 9, 2017
ShalokShalom
suggested changes
Sep 9, 2017
Contributor
|
Some of the sentences here use domain specific buzzwords and these ones do simply not exist in any other language, so how to translate? The giving result is currently a wild mix between English and German. Use words which are intelligible for humans without domain specific background in computer science.
Sometimes does it help, to replace such buzzwords with descriptions. This helps also to attract newbies. |
| # Browserunterst眉tzung | ||
|
|
||
| Prect unters眉tzt moderne Browser (Chrome, Firefox, Safari, Edge) und IE9+. Es sollte in IE7 sowie IE8 funktionieren, setzt allerdings einige Polyfiller voraus. Wenn es beabsichtigt ist, Preact zu benutzen und diese 盲lteren Browser zu unters眉tzen, wird empfohlen, einen Polyfiller wie zum Beispiel [es5-shim] oder [babel-polyfill] zu verwenden. | ||
| Preact unters眉tzt moderne Browser (Chrome, Firefox, Safari, Edge) und IE9+. Es sollte in IE7 sowie IE8 funktionieren, setzt allerdings einige Polyfiller voraus. Wenn es beabsichtigt ist, Preact zu benutzen und diese 盲lteren Browser zu unterst眉tzen, wird empfohlen, einen Polyfiller wie zum Beispiel [es5-shim] oder [babel-polyfill] zu verwenden. |
Member
There was a problem hiding this comment.
This would sound more clear in my opinion:
Preact unters眉tzt moderne Browser (Chrome, Firefox, Safari, Edge) und IE9+. In IE7 und IE8
sollte es funktionieren, allerdings werden einige Polyfills voraus gesetzt. Wenn Preact in
盲lteren Browsern verwendet werden soll, empfehlen wir einen Polyfiller wie zum Beispiel
[es5-shim] oder [babel-polyfill] zu verwenden.
Contributor
There was a problem hiding this comment.
Preact unterst眉tzt Chrome, Firefox, Safari, Edge sowie IE9+ vollst盲ndig und sollte auch in IE7 sowie IE8 weitgehend funktionieren, wobei dann einige Polyfills vorausgesetzt werden.
| |-----------------------------|--------------------------------------------------------------| | ||
| | `componentWillMount` | bevor die Komponente an das DOM eingehanden wird | | ||
| | `componentDidMount` | nachdem die Komponente an das DOM eingehanden wird | | ||
| | `componentWillMount` | bevor die Komponente in DOM eingebunden wird | |
Member
There was a problem hiding this comment.
in DOM -> im DOM / in dem DOM
| ## Versionenkompatibilit盲t | ||
|
|
||
| F眉r Preact und [preact-compat] gilt: Versionenkompatibilit wird gegen die _aktuellen_ und _vorherigen_ Hauptver枚ffentlichungen von React gemessen. Wenn neue Funktionen vom React-Team angek眉ndigt werden, werden sie, sollten sie mit den [Projektziele]n im Hinterkopf nutzvoll sein, zu Preacts Kern hinzugef眉gt. Dies ist ein recht demokratischer Prozess, der von sich konstant entwickelnden Diskussionen und Entscheidungen der Masse gezeichnet ist. Er lebt von Issues und Pull Requests. | ||
| F眉r Preact und [preact-compat] gilt: Versionenkompatibilit盲t wird mit den _aktuellen_ und _vorherigen_ Hauptver枚ffentlichungen von React verglichen. Wenn neue Funktionen vom React-Team angek眉ndigt werden sie, sollten sie mit den [Projektziele]n im Hinterkopf n眉tzlich sein, zu Preacts Kern hinzugef眉gt. Dies ist ein recht demokratischer Prozess, der von sich konstant entwickelnden Diskussionen und Entscheidungen der Masse gezeichnet ist. Er lebt von Issues und Pull Requests. |
Member
There was a problem hiding this comment.
...vom React-Team angek眉ndigt werden sie, sollten sie... -> ...vom React-Team angek眉ndigt werden, sollten sie...
Contributor
There was a problem hiding this comment.
Also das 'angek眉ndigt werden,' irritiert mich ma脽geblich
Member
There was a problem hiding this comment.
Vielleicht sollte der ganze Satz besser umformuliert werden :)
| - [Children]: Nicht notwendig in Preact, da `props.children` _immer ein Array_ ist. | ||
| - _`React.Children` ist vollst盲ndig in [preact-compat] unterst眉tzt._ | ||
| - Synthetisch Ereignisse: Preacts Ziel in der Browserunterst眉tzung setzt diesen zus盲tzlichen Mehraufwand nicht vorraus. | ||
| - Synthetische Ereignisse: Preacts Ziel in der Browserunterst眉tzung setzt diesen zus盲tzlichen Mehraufwand nicht vorraus. |
Member
There was a problem hiding this comment.
Sounds strange translating events to Ereignisse. It is the correct word in german but we usually do not translate technical terms. The german mdn docs don't translate events either: https://developer.mozilla.org/de/docs/Web/API/EventListener
|
|
||
|
|
||
| - `render()` akzeptiert ein drittes Argument, welches der Grundknoten zu _replace_ ist, andernfalls f眉gt es es hinzu. Dies k枚nnte sich in einer zuk眉nftigen Version ein wenig 盲ndern, vermutlich durch automatische Erkennung der Angemessenheit eines Ersatzrenders mithilfe einer Inspizierung des Grundknoten. | ||
| - `render()` akzeptiert ein drittes Argument, welches der Grundknoten zu _replace_ ist, andernfalls f眉gt es es hinzu. Dies k枚nnte sich in einer zuk眉nftigen Version ein wenig 盲ndern, vermutlich durch automatische Erkennung der Angemessenheit eines Ersatzrenders mithilfe einer Inspizierung des Grundknotens. |
Member
There was a problem hiding this comment.
What is meant with es es?
| Der Stellenwert von Vererbung in JavaScript ist umstritten, wenn man allerdings eine eigene "Basisklasse" erstellen will, von der alle anderen Komponenten erben, ist Preact genau richtig. | ||
|
|
||
| M枚glicherweise ist das Erstellen von automatischen Verbindungen zu Stores/Reducers in einer Flux-盲hnlichen Architektur gew眉nsht. Vielleicht mag man es auch, Eigentums-basierte Mixins hinzuzuf眉gen, damit es sich mehr wie `React.createClass` anf眉hlt _(Anmerkung: der [@`bind` decorator](https://github.com/developit/decko#bind) ist bevorzugt)_. | ||
| M枚glicherweise ist das Erstellen von automatischen Verbindungen zu Stores/Reducers in einer Flux-盲hnlichen Architektur gew眉nscht. Vielleicht mag man es auch, Eigentums-basierte Mixins hinzuzuf眉gen, damit es sich mehr wie `React.createClass` anf眉hlt _(Anmerkung: der [@`bind` decorator](https://github.com/developit/decko#bind) ist bevorzugt)_. |
Member
There was a problem hiding this comment.
Use english technical term for Eigentums-basierte Mixins.
| | `componentWillMount` | bevor die Komponente an das DOM eingehanden wird | | ||
| | `componentDidMount` | nachdem die Komponente an das DOM eingehanden wird | | ||
| | `componentWillMount` | bevor die Komponente in DOM eingebunden wird | | ||
| | `componentDidMount` | nachdem die Komponente in DOM eingebunden wurde | |
| Reacts Dokumentation zu ["Kontrollierten" Komponenten](https://facebook.github.io/react/docs/forms.html#controlled-components) und ["Unkontrollierten" Komponenten](https://facebook.github.io/react/docs/forms.html#uncontrolled-components) ist ungemein n眉tzlich, wenn man verstehen m枚chte, wie man HTML-Eingabemasken mit bidirektionalem Datenfluss benutzt und sich diese im Kontext eines komponentenbasierten DOM-Renderer, welche normalerweise unidirektionale Datenfl眉sse haben, zu Nutze macht. | ||
|
|
||
| Generell sollte man versuchen, immer _Kontrollierte_ Komponenten zu verwenden. Trotzdem kann es beim Erstellen von unabh盲ngigen Komponenten oder umschlie脽enden Drittanbieter-UI-Bibliotheken sehr n眉tzelich sein, die Komponente einfach als Mount-Punkt f眉r Non-Preact-Funktionalit盲ten zu verwenden. In diesen F盲llen sind _Unkontrollierte_ Komponenten genau richtig f眉r die Aufgabe. | ||
| Generell sollte man versuchen, immer _Kontrollierte_ Komponenten zu verwenden. Trotzdem kann es beim Erstellen von unabh盲ngigen Komponenten oder umschlie脽enden Drittanbieter-UI-Bibliotheken sehr n眉tzlich sein, die Komponente einfach als Mount-Punkt f眉r Non-Preact-Funktionalit盲ten zu verwenden. In diesen F盲llen sind _Unkontrollierte_ Komponenten genau richtig f眉r die Aufgabe. |
| ## Kontrollbox & Radio Buttons | ||
|
|
||
| Kontrollboxe und Radio Buttons (`<input type="checkbox|radio">`) kann anf盲nglich f眉r Verwirrung sorgen, wenn man kontrollierte Eingabemasken erstellt. Dies ist damit zu begr眉nden, dass man in einer unkontrollieren Umgebung normalerweise dem Browser erlauben w眉rden, eine Kontrollbox oder einen Radio Button f眉r uns "umzuschalten" oder "anzukreuzen", auf 脛nderungsereignisse zu warten und auf den neuen Wert zu reagieren. Allerdings geht diese Technik nicht sonderlich gut in ein Weltbild 眉ber, in dem da UI immer wieder automatisch als Reaktion auf state- und prop-脛nderungen aktualisiert wird. | ||
| Kontrollboxen und Radio Buttons (`<input type="checkbox|radio">`) k枚nnen anf盲nglich f眉r Verwirrung sorgen, wenn man kontrollierte Eingabemasken erstellt. Das liegt daran, dass man in einer unkontrollieren Umgebung normalerweise dem Browser erlauben w眉rden, eine Kontrollbox oder einen Radio Button f眉r uns "umzuschalten" oder "anzukreuzen", auf 脛nderungsereignisse zu warten und auf den neuen Wert zu reagieren. Allerdings funktioniert diese Technik nicht sonderlich gut in einem Szenario, in dem das UI immer wieder automatisch als Reaktion auf state- und prop-脛nderungen aktualisiert wird. |
Member
There was a problem hiding this comment.
...immer wieder automatisch auf state- und prop-脛nderungen reagiert.
| Kontrollboxen und Radio Buttons (`<input type="checkbox|radio">`) k枚nnen anf盲nglich f眉r Verwirrung sorgen, wenn man kontrollierte Eingabemasken erstellt. Das liegt daran, dass man in einer unkontrollieren Umgebung normalerweise dem Browser erlauben w眉rden, eine Kontrollbox oder einen Radio Button f眉r uns "umzuschalten" oder "anzukreuzen", auf 脛nderungsereignisse zu warten und auf den neuen Wert zu reagieren. Allerdings funktioniert diese Technik nicht sonderlich gut in einem Szenario, in dem das UI immer wieder automatisch als Reaktion auf state- und prop-脛nderungen aktualisiert wird. | ||
|
|
||
| > **Durchlauf:** Man geht davon aus, dass wir auf ein "脛nderungs"ereignis einer Kontrollbox warten, welches ausgel枚st wird, wenn die Kontrollbox ausgew盲hlt oder aufgehoben wird. Der 脛nderungsereignis-Handler wird ein Wert in `state` dem neuen Wert, der von der Kontrollbox empfangen wird, zugeordnet. Dies l枚st das Neurendern der Komponente aus, was den Wert der Kontrollbox dem Wert von state neu zuordnen wird. Das ist allerdings unn枚tig, das wir gerade beim DOM einen Wert angefragt haben, ihm dann aber das Neurendern mit dem gew眉nschten Wert befohlen haben. | ||
| > **Durchlauf:** Nehmen wir an, dass wir auf ein "脛nderungs"ereignis einer Kontrollbox warten, welches ausgel枚st wird, wenn die Kontrollbox ausgew盲hlt oder aufgehoben wird. Der 脛nderungsereignis-Handler wird ein Wert in `state` dem neuen Wert, der von der Kontrollbox empfangen wird, zugeordnet. Dies l枚st das Neurendern der Komponente aus, was den Wert der Kontrollbox dem Wert von state neu zuordnen wird. Das ist allerdings unn枚tig, da wir gerade beim DOM einen Wert angefragt haben, ihm dann aber das Neurendern mit dem gew眉nschten Wert befohlen haben. |
Member
There was a problem hiding this comment.
"脛nderungsereignis", better to use the english technical term, though
| |-----------------------------|--------------------------------------------------------------| | ||
| | `componentWillMount` | bevor die Komponente an das DOM eingehanden wird | | ||
| | `componentDidMount` | nachdem die Komponente an das DOM eingehanden wird | | ||
| | `componentWillMount` | bevor die Komponente in DOM eingebunden wird | |
| | `componentWillMount` | bevor die Komponente an das DOM eingehanden wird | | ||
| | `componentDidMount` | nachdem die Komponente an das DOM eingehanden wird | | ||
| | `componentWillMount` | bevor die Komponente in DOM eingebunden wird | | ||
| | `componentDidMount` | nachdem die Komponente in DOM eingebunden wurde | |
| Gl眉cklicherweise gibt es eine L枚sung in Form von Preacts [`linkState`](https://github.com/developit/linkstate)-Modul. | ||
|
|
||
| > Fr眉here Versionen von Preact hatten die `linkState()`-Funktion bereits von Grund auf eingebaut, sie wurde mittlerweile aber in ein seperates Modul verschoben. Wenn man zum alten Verhalten zur眉ckwechseln m枚chte, findet man auf [dieser Seite](https://github.com/developit/linkstate#usage) Informationen zur Anwendung dieses Polyfills. | ||
| > Fr眉here Versionen von Preact hatten die `linkState()`-Funktion bereits von Grund auf implementiert, sie wurde mittlerweile aber in ein seperates Modul verschoben. Wenn man zum alten Verhalten zur眉ckwechseln m枚chte, findet man auf [dieser Seite](https://github.com/developit/linkstate#usage) Informationen zur Anwendung dieses Polyfills. |
Member
There was a problem hiding this comment.
von Grund auf -> von Haus aus
| > Fr眉here Versionen von Preact hatten die `linkState()`-Funktion bereits von Grund auf implementiert, sie wurde mittlerweile aber in ein seperates Modul verschoben. Wenn man zum alten Verhalten zur眉ckwechseln m枚chte, findet man auf [dieser Seite](https://github.com/developit/linkstate#usage) Informationen zur Anwendung dieses Polyfills. | ||
|
|
||
| Das Aufrufen von `linkState(this, 'text')` gibt eine Handler-Funktion aus, die, falls an diese ein Ereignis weitergegeben wird, seinen zugewiesen Wert zum Aktualisieren der bestimmten Property des States der Komponente benutzt. Mehrere Aufrufe an `linkState(component, name)` mit der selben `component` und `name` werde gecached, sodass man nicht mit Leistungseinbu脽e rechnen muss. | ||
| Das Aufrufen von `linkState(this, 'text')` gibt eine Handler-Funktion aus, die, falls an diese ein Ereignis weitergegeben wird, seinen zugewiesen Wert zum Aktualisieren der bestimmten Property des States der Komponente benutzt. Mehrere Aufrufe an `linkState(component, name)` mit der selben `component` und `name` werde gecached, sodass man nicht mit Leistungseinbu脽en rechnen muss. |
Contributor
|
Vielen herzlichen Dank Marvin, well done |
Otto-AA
reviewed
Aug 16, 2018
| <h3>Weniger Skripte laden</h3> | ||
| </div> | ||
| <p class="_summary">Preact's [kleine Gr枚脽e](/about/project-goals) ist sehr wertvoll, wenn nur ein begr盲nztes Ladezeitenkontingent verf眉gbar ist. Man kann davon ausgehen, dass das Laden von gro脽en JavaScript-Bibliotheken mit mobilen Endger盲ten immense Wartezeiten bis zur Benutzbarkeit der Applikation f眉hren kann. Das Laden, Evaluieren und Berechnen der Skripte ist zu ressourcenhungrig. Das Reduzieren der Gr枚脽e von Bibliotheken f眉hrt automatisch zu verbesserten Ladezeiten, da folglich auch weniger Code geladen und berechnet werden muss.</p> | ||
| <p class="_summary">Preact's [kleine Gr枚脽e](/about/project-goals) ist sehr wertvoll, wenn nur ein begrenztes Ladezeitenkontingent verf眉gbar ist. Man kann davon ausgehen, dass das Laden von gro脽en JavaScript-Bibliotheken mit mobilen Endger盲ten immense Wartezeiten bis zur Benutzbarkeit der Applikation f眉hren kann. Das Laden, Evaluieren und Berechnen der Skripte ist zu ressourcenhungrig. Das Reduzieren der Gr枚脽e von Bibliotheken f眉hrt automatisch zu verbesserten Ladezeiten, da folglich auch weniger Code geladen und berechnet werden muss.</p> |
Contributor
There was a problem hiding this comment.
I'd prefer to write it like [...] zu immensen Wartezeiten [...] f眉hren kann.
"Man kann davon ausgehen, dass das Laden von gro脽en JavaScript-Bibliotheken mit mobilen Endger盲ten zu immensen Wartezeiten bis zur Benutzbarkeit der Applikation f眉hren kann." (edited)
Contributor
There was a problem hiding this comment.
Danke, habs dazugegeben :)
Contributor
|
Maybe we can merge this one year after? |
Member
|
I should think so! Couple of minor conflicts to resolve but we should definitely get this out. @marvinhagemeister - think we're good to sign off on this? |
Member
|
Any updates on this? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Unfortunately my English/German is not so good to simplify further.