-
Notifications
You must be signed in to change notification settings - Fork 1.2k
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
docs: german translation #851
base: main
Are you sure you want to change the base?
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
⚡️ Lighthouse report for the changes in this PR:
Lighthouse ran on https://create-t3-app-git-fork-jln13x-jln-german-docs-t3-oss.vercel.app/ |
e4ba4b5
to
67c2afd
Compare
Co-authored-by: Bennett Dams <dams.bennett@gmail.com>
Co-authored-by: Bennett Dams <dams.bennett@gmail.com>
Co-authored-by: Bennett Dams <dams.bennett@gmail.com>
Co-authored-by: Bennett Dams <dams.bennett@gmail.com>
@jln13x Looks good so far! |
@@ -1,15 +1,15 @@ | |||
--- |
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.
How should we handle the T3 Collection across multiple languages?
One across all? Or language specific (companies aswell as projects)?
I prefer one collection across all
Co-authored-by: Bennett Dams <dams.bennett@gmail.com>
Conflicts |
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.
Reviewing translations take even longer than I thought, will try to review 1-2 pages a day from now on.
We should decide on a good translation for "full-stack" and use it consistently (or maybe just keep it but capitalise?). Open to suggestions about this.
|
||
## Der T3 Stack | ||
|
||
Der _"T3 Stack"_ ist ein Webentwicklungsstack von [Theo](https://twitter.com/t3dotgg), der sich auf Einfachheit, Modularität und vollständige Typensicherheit konzentriert. |
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.
"vollständige" feels like a strange translation of "full-stack" here, but not sure what would be better
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.
I think people use "Ende-zu-Ende" for E2E encryption, could work here?
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.
"vollständige" feels like a strange translation of "full-stack" here, but not sure what would be better
ye lets stick with full stack for now, seems pretty commonly used even in german
www/src/pages/de/introduction.md
Outdated
|
||
### Modern und verantwortungsbewusst | ||
|
||
Wir lieben unsere modernen Technologien. Die Geschwindigkeit und, ehrlich gesagt, der Spaß, der aus dem neuen Zeug entsteht, ist wirklich cool. Wir denken, dass es wichtig ist, verantwortungsvoll zu sein und riskantere Technologien in den weniger riskanten Teilen zu verwenden. Das bedeutet, dass wir nicht ⛔️ auf riskante neue Datenbanktechnologien setzen würden (SQL ist toll!). Aber wir setzen gerne ✅ auf tRPC, da es sich nur um Funktionen handelt, die trivial zu verlagern sind. |
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.
Is this DeepL? Some bits don't really make sense imo.
Wir lieben unsere modernen Technologien. Die Geschwindigkeit und, ehrlich gesagt, der Spaß, der aus dem neuen Zeug entsteht, ist wirklich cool. Wir denken, dass es wichtig ist, verantwortungsvoll zu sein und riskantere Technologien in den weniger riskanten Teilen zu verwenden. Das bedeutet, dass wir nicht ⛔️ auf riskante neue Datenbanktechnologien setzen würden (SQL ist toll!). Aber wir setzen gerne ✅ auf tRPC, da es sich nur um Funktionen handelt, die trivial zu verlagern sind. | |
Wir lieben unsere modernen Technologien. Die Geschwindigkeit und, ehrlich gesagt, der Spaß, der aus dem neuen Zeug entsteht, ist wirklich cool. Wir denken, dass es wichtig ist, verantwortungsvoll zu sein und riskantere Technologien in den weniger riskanten Teilen zu verwenden. Das bedeutet, dass wir nicht ⛔️ auf riskante neue Datenbanktechnologien setzen würden (SQL ist toll!). Aber wir setzen gerne ✅ auf tRPC, da es sich nur um Funktionen handelt, die trivial zu verlagern sind. |
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.
"in den weniger kritischen Teilen" / "in den weniger kritischen Systemen"
Wouldn't use "riskant" twice and I'm not sure what a risky system is, sounds weird to me.
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.
@Coyenn wanna take care of it?
Co-authored-by: Christopher Ehrlich <ehrlich.christopher@gmail.com>
please add this #970 |
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.
My comments are to be understood as suggestions not as "must-change" (excluding the two typos).
I mostly looked at wording and reading flow.
I haven't looked at the trpc file yet.
{ text: "Installation", link: "de/installation" }, | ||
{ text: "Ordnerstruktur", link: "de/folder-structure" }, | ||
{ text: "FAQ", link: "de/faq" }, | ||
{ text: "T3 Sammlung", link: "de/t3-collection" }, |
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.
I don't know whether Sammlung is the word that we want here maybe something more like T3 powered but that would be an overall not language specific suggestion.
|
||
## Docker Projektkonfiguration | ||
|
||
Next.js benötigt unterschiedliche Vorgehensweisen für Variablen, die zur "Build time" gesetzt werden (verfügbar im Frontend, gepräfixt durch `NEXT_PUBLIC`) und Variablen, die nur serverseitig zur Laufzeit verfügbar sein sollen. Bitte beachte also die Anordnung der Variablen in der Befehlszeile, der `Dockerfile` und der `docker-compose.yml` Datei. |
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.
Maybe keep it like it would be in english e.g. "build time"
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.
lowercase b or what do u mean?
|
||
It provides live feedback as you write your code by defining expected data types, and either provides helpful autocomplete in your code editor, or yells at you with red squiggly lines if you're trying to access a property that doesn't exist or trying to pass a value of the wrong type, which you would otherwise have to debug further down the line. | ||
Es bietet Live-Feedback während du deinen Code schreibst. Die erwarteten Datentypen werden definiert und entweder erhalten wir hilfreiche Autovervollständigung in unserem Code-Editor oder es wird uns mit roten Unterstrichen auf ein Problem aufmerksam gemacht z.B. wenn wir versuchen auf eine Eigenschaft zuzugreifen, die nicht existiert oder wenn wir versuchen einen Wert eines falschen Typs zu übergeben. Dadurch können wir Fehler frühzeitig erkennen und beheben ohne erst im Nachhinein debuggen zu müssen. |
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.
I generally enjoy a more "personal" approach when writing docs. So I generally try to speak to the reader with things like "dir" etc. So I like the suggestion. anOatFlake made.
|
||
## Warum Next.js? | ||
|
||
Wir lieben React. Es hat die Entwicklung von UIs zugänglich gemacht, auf eine Art und Weise, die wir uns vorher niemals hätten vorstellen können. Es kann Entwickler jedoch auch auf einige holprige Pfade führen. |
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.
Es hat die Entwicklung von UIs auf eine Art und Weise zugänglich gemacht, die wir uns vorher nicht einmal erträumt hätten.
|
||
## Warum tRPC/Prisma/Tailwind/etc? | ||
|
||
Auch wenn Befürworter davon sind, Dinge so einfach wie möglich zu halten, finden wir, dass diese Teile in jeder Anwendung verwendet werden, die wir erstellen. `create-t3-app` macht es einfach für dich die Teile hinzuzufügen, die du benötigst. |
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.
Typo: Auch wenn wir Befürworter...
Tailwind fühlt sich wie "Zen-Modus CSS" an. | ||
|
||
Tailwind ermöglicht es dir eine anschauliche Anwendung zu erstellen, indem es dir die Grundbausteine in Form von guten Standardfarben, Abständen und anderen Primitiven zur Verfügung stellt. Im Gegensatz zu Komponentenbibliotheken wirst du nicht dabei zurück gehalten, wenn deine Anwendung auf das nächste Level bringen möchtest und etwas außergewöhnliches und einzigartiges erstellen möchtest. | ||
|
||
Zusätzlich sorgt die "inline" Herangehensweise von Tailwind dafür, dass du dich nicht um Klassennamen, Ordnerstruktur oder andere Probleme sorgen musst, die nicht direkt mit dem Problem zu tun haben, dass du lösen möchtest. | ||
|
||
### NextAuth.js | ||
|
||
Wenn du ein Authentifizierungssystem in deiner Next.js-Anwendung haben möchtest, ist NextAuth.js eine ausgezeichnete Lösung, um die Komplexität zu vermeiden, es selbst zu bauen. Es kommt mit einer umfangreichen Liste von Providern, um OAuth-Authentifizierung schnell hinzuzufügen und bietet Adapter für viele Datenbanken und ORMs. |
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.
Why did you guys settle on a you centric approach in the end when the rest was we?
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.
This was quite a huge MR. Kudos to the translator 🎉🚀
|
||
#### `src/server/trpc/trpc.ts` | ||
|
||
Die `trpc.ts` Datei wird verwendet, um die Helferfunktionen für die Prozeduren zu exportieren. Weitere Informationen findest du unter [Verwendung von tRPC](/de/usage/trpc#-servertrpctrpcts). |
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.
Please verify that servertrpctrpcts
is correct.
|
||
#### `src/server/trpc/router/_app.ts` | ||
|
||
Die `_app.ts` Datei wird verwendet, um tRPC-Routen zusammenzuführen und diese als einzelnen Router sowie die Typdefinitionen zu exportieren. Weitere Informationen findest du unter [Verwendung von tRPC](/de/usage/trpc#-servertrpcrouterts). |
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.
Please verify that servertrpctrpcts is correct.
|
||
### `src/types` | ||
|
||
Der `types` Ordner wird verwendet, um wiederverwendete Typen oder Typdeklarationen zu speichern. |
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.
Consider using "zu sammeln." instead of "zu speichern."
Co-authored-by: John <80417067+dorbn4@users.noreply.github.com>
Not much time right now to finish up the leftovers. Would appreciate some help from the community |
✅ Checklist
Changelog
deployment
usage
faq.md
folder-structure.md
installation.md
introduction.md
other-recs.md
t3-collection.md
why.md
Screenshots
[Screenshots]