Skip to content
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

Open
wants to merge 39 commits into
base: main
Choose a base branch
from
Open

docs: german translation #851

wants to merge 39 commits into from

Conversation

jln13x
Copy link
Contributor

@jln13x jln13x commented Nov 23, 2022

✅ Checklist

  • I have followed every step in the contributing guide (updated 2022-10-06).
  • The PR title follows the convention we established conventional-commit
  • I performed a functional test on my final commit

Changelog

  • deployment

    • docker.md
    • vercel.md
  • usage

    • env-variables.md
    • first-steps.md
    • next-auth.md
    • next-js.md
    • prisma.md
    • tailwind.md
    • trpc.md
    • typescript.md
  • faq.md

  • folder-structure.md

  • installation.md

  • introduction.md

  • other-recs.md

  • t3-collection.md

  • why.md


Screenshots

[Screenshots]

@changeset-bot
Copy link

changeset-bot bot commented Nov 23, 2022

⚠️ No Changeset found

Latest commit: 827682b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Nov 23, 2022

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated
create-t3-app ✅ Ready (Inspect) Visit Preview 💬 Add your feedback Feb 1, 2023 at 9:25PM (UTC)

@github-actions github-actions bot added the 📚 documentation Improvements or additions to documentation label Nov 23, 2022
@github-actions
Copy link
Contributor

github-actions bot commented Nov 23, 2022

⚡️ Lighthouse report for the changes in this PR:

Category Score
🟢 Performance 92
🟢 Accessibility 100
🟢 Best practices 100
🟢 SEO 93
🟠 PWA 54

Lighthouse ran on https://create-t3-app-git-fork-jln13x-jln-german-docs-t3-oss.vercel.app/

www/src/pages/de/deployment/docker.md Outdated Show resolved Hide resolved
www/src/pages/de/deployment/docker.md Outdated Show resolved Hide resolved
www/src/pages/de/deployment/docker.md Outdated Show resolved Hide resolved
www/src/pages/de/deployment/vercel.md Outdated Show resolved Hide resolved
@Coyenn
Copy link
Collaborator

Coyenn commented Nov 24, 2022

@jln13x Looks good so far!
@bennettdams Thank you for fixing the typos!

@@ -1,15 +1,15 @@
---
Copy link
Contributor Author

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

@juliusmarminge
Copy link
Member

Conflicts

Copy link
Member

@c-ehrlich c-ehrlich left a 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.
Copy link
Member

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

Copy link
Contributor

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?

Copy link
Contributor Author

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 Show resolved Hide resolved

### 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.
Copy link
Member

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.

Suggested change
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.

Copy link
Contributor

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.

Copy link
Contributor Author

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?

www/src/pages/de/introduction.md Outdated Show resolved Hide resolved
Co-authored-by: Christopher Ehrlich <[email protected]>
@c-ehrlich
Copy link
Member

please add this #970

@juliusmarminge juliusmarminge added the 🙏 community review required A review from the community is required label Dec 18, 2022
Copy link

@petute petute left a 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" },
Copy link

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.

www/src/pages/de/deployment/docker.md Outdated Show resolved Hide resolved

## 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.
Copy link

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"

Copy link
Contributor Author

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?

www/src/pages/de/deployment/docker.md Outdated Show resolved Hide resolved
www/src/pages/de/deployment/docker.md Outdated Show resolved Hide resolved
www/src/pages/de/usage/typescript.md Outdated Show resolved Hide resolved

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.
Copy link

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.
Copy link

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.
Copy link

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...

Comment on lines +44 to +52
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.
Copy link

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?

Copy link

@dorbn4 dorbn4 left a 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 🎉🚀

www/src/pages/de/faq.md Show resolved Hide resolved

#### `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).
Copy link

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).
Copy link

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.
Copy link

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."

www/src/pages/de/folder-structure.md Outdated Show resolved Hide resolved
www/src/pages/de/faq.md Outdated Show resolved Hide resolved
www/src/pages/de/faq.md Outdated Show resolved Hide resolved
www/src/pages/de/folder-structure.md Outdated Show resolved Hide resolved
www/src/pages/de/folder-structure.md Outdated Show resolved Hide resolved
www/src/pages/de/folder-structure.md Outdated Show resolved Hide resolved
@jln13x
Copy link
Contributor Author

jln13x commented Feb 21, 2023

Not much time right now to finish up the leftovers. Would appreciate some help from the community

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🙏 community review required A review from the community is required 📚 documentation Improvements or additions to documentation 🌎 translation Translation of documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

9 participants