docs: german translation #851
Conversation
|
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
github-actions
bot
added
the
📚 documentation
|
⚡️ 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/ |
jln13x
force-pushed
the
jln/german-docs
branch
from
e4ba4b5
to
67c2afd
Compare
Co-authored-by: Bennett Dams <[email protected]>
Co-authored-by: Bennett Dams <[email protected]>
Co-authored-by: Bennett Dams <[email protected]>
Co-authored-by: Bennett Dams <[email protected]>
|
@jln13x Looks good so far! |
| @@ -1,15 +1,15 @@ | |||
| --- | |||
There was a problem hiding this comment.
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
jln13x
requested review from
juliusmarminge,
nexxeln,
t3dotgg and
c-ehrlich
as code owners
Co-authored-by: Bennett Dams <[email protected]>
|
Conflicts |
|
|
||
| ## 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.
"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.
I think people use "Ende-zu-Ende" for E2E encryption, could work here?
There was a problem hiding this comment.
"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.
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.
"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.
@Coyenn wanna take care of it?
Co-authored-by: Christopher Ehrlich <[email protected]>
|
please add this #970 |
juliusmarminge
added
the
🙏 community review required
| { 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.
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.
Maybe keep it like it would be in english e.g. "build time"
There was a problem hiding this comment.
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.
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.
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. |
| 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.
Why did you guys settle on a you centric approach in the end when the rest was we?
|
|
||
| #### `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.
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.
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.
Consider using "zu sammeln." instead of "zu speichern."
Co-authored-by: John <[email protected]>
|
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]