Skip to content

Commit

Permalink
docs: apply suggestions
Browse files Browse the repository at this point in the history
Co-authored-by: John <80417067+dorbn4@users.noreply.github.com>
  • Loading branch information
jln13x and dorbn4 committed Feb 1, 2023
1 parent d100c25 commit 827682b
Show file tree
Hide file tree
Showing 9 changed files with 27 additions and 28 deletions.
4 changes: 2 additions & 2 deletions www/src/pages/de/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Wir wissen, dass dieser Weg nicht für jeden funktioniert. Wenn du dir also sich

Wie in [T3-Axiom #3](/de/introduction#typesafety-isnt-optional) beschrieben, nehmen wir Typsicherheit sehr ernst. Leider unterstützen nicht alle Frameworks und Plugins TypeScript, was bedeutet, dass einige Konfigurationsdateien `.js`-Dateien sein müssen.

Wir versuchen hervorzuheben, dass diese Dateien aus einem bestimmten Grund in JavaScript geschrieben sind, indem wir den Typ (`cjs` oder `mjs`) jeder Datei explizit deklarieren (abhängig davon, was von der zugehörigen Bibliothek unterstützt wird).Außerdem werden alle `js`-Dateien in diesem Projekt weiterhin mit einem `@ts-check`-Kommentar am Anfang auf korrekte Typen geprüft.
Wir versuchen hervorzuheben, dass diese Dateien aus einem bestimmten Grund in JavaScript geschrieben sind, indem wir den Typ (`cjs` oder `mjs`) jeder Datei explizit deklarieren (abhängig davon, was von der zugehörigen Bibliothek unterstützt wird). Außerdem werden alle `js`-Dateien in diesem Projekt weiterhin mit einem `@ts-check`-Kommentar am Anfang auf korrekte Typen geprüft.

## Ich habe Schwierigkeiten, i18n zu meiner App hinzuzufügen. Gibt es eine Referenz, die ich verwenden kann?

Expand All @@ -54,6 +54,6 @@ Wenn du jedoch Schwierigkeiten hast, dies zu implementieren und eine Referenzpro

## Warum verwenden wir `/pages` und nicht `/app` von Next.js 13?

Wie in [T3-Axiom #2](/de/introduction#bleed-responsibly) beschrieben lieben wir neue Technologien, jeoch legen wir großen Wert auf Stabilität. Deinen gesamten Router umzuziehen ist schwierig und es ist keine gute Idee dort diese Risiken einzugehen (siehe [bleed responsibly](<(https://youtu.be/mnwUbtieOuI?t=1662)>)). Auch wenn `/app` ein [Vorgeschmack auf die Zukunft](https://youtu.be/rnsC-12PVlM?t=818) ist, ist es noch nicht für bereit dafür im Produktivbetrieb eingesetzt zu werden. Die API befindet sich noch in der Beta und wird wahrscheinlich noch Breaking Changes haben.
Wie in [T3-Axiom #2](/de/introduction#bleed-responsibly) beschrieben lieben wir neue Technologien, jedoch legen wir großen Wert auf Stabilität. Deinen gesamten Router umzuziehen ist schwierig und es ist keine gute Idee an einer so elementaren Stelle diese Risiken einzugehen (siehe [bleed responsibly](<(https://youtu.be/mnwUbtieOuI?t=1662)>)). Auch wenn `/app` ein [Vorgeschmack auf die Zukunft](https://youtu.be/rnsC-12PVlM?t=818) ist, ist es noch nicht für bereit im Produktivbetrieb eingesetzt zu werden. Die API befindet sich noch in der Beta und wird wahrscheinlich noch Breaking Changes haben.

Schau dir die [Beta Next.js Dokumentation](https://beta.nextjs.org/docs/app-directory-roadmap#supported-and-planned-features) an um eine Liste der unterstützten, geplanten und in Arbeit befindlichen Funktionen im `/app`-Verzeichnis zu sehen.
12 changes: 6 additions & 6 deletions www/src/pages/de/folder-structure.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ lang: de

Nachfolgend ist die Ordnerstruktur einer neu erstellten T3 App zu sehen, bei der alle Optionen ausgewählt wurden.

Die Beschreibung jedes Ordners gibt an, welchen Zweck er erfüllt und ob er nur bei ausgewählten Bibliotheken enthalten ist.
Die Beschreibung jedes Ordners gibt an, welchen Zweck dieser erfüllt und ob dieser nur bei ausgewählten Bibliotheken enthalten ist.

```
.
Expand Down Expand Up @@ -151,13 +151,13 @@ Die `_app.ts` Datei wird verwendet, um tRPC-Routen zusammenzuführen und diese a

#### `src/server/trpc/router/auth.ts`

Die `auth.ts´ Datei ist ein Beispiel für eine tRPC-Routen, die die `protectedProcedure`-Hilfsfunktion verwendet, um zu demonstrieren, wie eine tRPC-Routen mit NextAuth.js geschützt werden kann.
Die `auth.ts´ Datei ist ein Beispiel für eine tRPC-Route, die die `protectedProcedure`-Hilfsfunktion verwendet, um zu demonstrieren, wie eine tRPC-Routen mit NextAuth.js geschützt werden kann.

<sub>(mit NextAuth.js + tRPC)</sub>

#### `src/server/trpc/router/example.ts`

Die `example.ts` Datei ist ein Beispiel für einen tRPC-Router, die die `publicProcedure`-Hilfsfunktion verwendet, um zu demonstrieren, wie eine tRPC-Routen ohne Authentifizierung erstellt werden kann.
Die `example.ts` Datei ist ein Beispiel für einen tRPC-Router, der die `publicProcedure`-Hilfsfunktion verwendet, um zu demonstrieren, wie eine tRPC-Routen ohne Authentifizierung erstellt werden kann.

<sub>(mit tRPC)</sub>

Expand All @@ -175,7 +175,7 @@ Der `types` Ordner wird verwendet, um wiederverwendete Typen oder Typdeklaration

#### `src/types/next-auth.d.ts`

Die `next-auth.d.ts` Datei wird verwendet, um den Standardtyp der NextAuth-Sitzung um die Benutzer-ID zu erweitern. Weitere Informationen findest du unter [Verwendung von NextAuth.js](/de/usage/next-auth#inclusion-of-userid-on-the-session) .
Die `next-auth.d.ts` Datei wird verwendet, um den Standardtyp der NextAuth-Sitzung um die Benutzer-ID zu erweitern. Weitere Informationen findest du unter [Verwendung von NextAuth.js](/de/usage/next-auth#inclusion-of-userid-on-the-session).

<sub>(mit NextAuth.js)</sub>

Expand Down Expand Up @@ -209,7 +209,7 @@ Die `next-env.d.ts` Datei stellt sicher, dass die Next.js Typen vom TypeScript-C

### `next.config.mjs`

Die `next.config.mjs` Datei wird verwendet, um Next.js zu konfigurieren. Weitere Informationen findest du in der [Next.js Dokumentation](https://nextjs.org/docs/api-reference/next.config.js/introduction). Hinweis: Die .mjs Dateiende wird verwendet, um ESM-Importe zu ermöglichen.
Die `next.config.mjs` Datei wird verwendet, um Next.js zu konfigurieren. Weitere Informationen findest du in der [Next.js Dokumentation](https://nextjs.org/docs/api-reference/next.config.js/introduction). Hinweis: Die .mjs Dateiendung wird verwendet, um ESM-Importe zu ermöglichen.

### `postcss.config.cjs`

Expand All @@ -225,4 +225,4 @@ Die `prettier.config.cjs` Datei wird verwendet, um Prettier zu konfigurieren und

### `tsconfig.json`

Die `tsconfig.json` Datei wird verwendet, um TypeScript zu konfigurieren. Einige nicht-Standardwerte, wie `strict mode` wurden aktiviert, um die beste Verwendung von TypeScript für `create-t3-app` und die verwendeten Bibliotheken zu gewährleisten. Weitere Informationen findest du in der [TypeScript Dokumentation](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) oder [Verwendung von TypeScript](/de/usage/typescript).
Die `tsconfig.json` Datei wird verwendet, um TypeScript zu konfigurieren. Einige nicht-Standardwerte, wie `strict mode` wurden aktiviert, um die beste Verwendung von TypeScript für `create-t3-app` und die verwendeten Bibliotheken zu gewährleisten. Weitere Informationen findest du in der [TypeScript Dokumentation](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) und [Verwendung von TypeScript](/de/usage/typescript).
4 changes: 2 additions & 2 deletions www/src/pages/de/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ layout: ../../layouts/docs.astro
lang: de
---

Um eine App mit `create-t3-app` zu erstellen, führe eines der folgenden drei Kommandos aus und beantworte die Fragen des Kommandozeilen-Prompts:
Um eine App mit `create-t3-app` zu erstellen, führe eines der folgenden drei Befehle aus und beantworte die Fragen über dein Terminal:

### npm

Expand Down Expand Up @@ -48,7 +48,7 @@ Wir haben einige experimentelle Flags, die es dir ermöglichen, eine App ohne je
| `--nextAuth` | Fügt NextAuth.js zum Projekt hinzu |
| `--tailwind` | Fügt Tailwind CSS zum Projekt hinzu |

**Hinweis: Wenn du die `CI` Flag nicht angibst, haben die restliche Flags keine Auswirkung.**
**Hinweis: Wenn du die `CI` Flag nicht angibst, haben die restlichen Flags keine Auswirkung.**

Du musst nicht explizit die Pakete ausschließen, die du nicht möchtest. Wenn du aber explizit sein möchtest, kannst du `false` übergeben, z.B. `--nextAuth false`.

Expand Down
3 changes: 1 addition & 2 deletions www/src/pages/de/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,13 @@ Du hast vielleicht bemerkt, dass der T3-Stack viele Bestandteile hat. Das ist so

Irgendwie? `create-t3-app` ist eine CLI, die von erfahrenen T3-Stack-Entwicklern entwickelt wurde, um die Einrichtung einer modularen T3-Stack-App zu vereinfachen. Das bedeutet, dass jeder Bestandteil optional ist und das "Template" auf der Grundlage deiner spezifischen Anforderungen erstellt wird.

After countless projects and many years on this tech, we have lots of opinions and insights. We've done our best to encode them into this CLI.
Nach unzähligen Projekten und vielen Jahren auf diesem Gebiet haben wir viele Meinungen und Erkenntnisse. Wir haben unser Bestes getan, um sie in dieser CLI zu verwirklichen.

Das hier ist **KEINE** allumfassende Vorlage. Wir **erwarten**, dass du deine eigenen Bibliotheken einbringst, die die Anforderungen **DEINER** Anwendung erfüllen. Wir wollen zwar keine Lösungen für spezifischere Probleme wie Zustandsverwaltung und Deployment vorschreiben, aber wir [haben hier einige Empfehlungen aufgelistet](/de/other-recs).

## T3 Grundsätze

Das Projekt wurde nach _unseren Vorstellungen_ gestaltet. Wir teilen eine Reihe an Überzeugungen für das Bauen von Web-Applikationen und nutzen diese als Basis für unsere Entscheidungen.
Das Projekt wurde nach _unseren Vorstellungen_ gestaltet. Wir teilen eine Reihe an Überzeugungen für das Erstellen von Web-Applikationen und nutzen diese als Basis für unsere Entscheidungen.

### Probleme lösen

Expand Down
18 changes: 9 additions & 9 deletions www/src/pages/de/other-recs.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ lang: de
---

Wir sind uns bewusst darüber, dass die Bibliotheken, die in `create-t3-app` enthalten sind, nicht jedes Problem lösen.
Während wir dich dazu ermutigen möchten dein Projekt mit den Dingen zu beginnen, die wir zur Verfügung stellen, wird es sicherlich ein Zeitpunkt kommen, an dem du andere Pakete einbinden musst. Nur du kannst wissen, was dein Projekt braucht, aber hier sind einige Dinge, die wir uns häufig empfehlen.
Während wir dich dazu ermutigen möchten dein Projekt mit den Dingen zu beginnen, die wir zur Verfügung stellen, wird es sicherlich zu ein Zeitpunkt kommen, an dem du andere Pakete einbinden musst. Nur du kannst wissen, was dein Projekt braucht, aber hier sind einige Dinge, die wir gerne und häufig empfehlen.

Diese Empfehlungen stammen von einzelnen create-t3-app Mitwirkenden und sollte nicht als "offizielle" Bekanntmachung
durch das create-t3-app Team oder T3-OSS gesehen werden. _**Bitte führe deine eigene Recherche durch, insbesondere bevor du dich für kostenpflichtige Dienste entscheidest**_.
Expand All @@ -17,7 +17,7 @@ _**Hinweis**_: State Management Bibliotheken können großartig sein sind aber o

### Zustand

**Um nie wieder Redux zu verwenden zu müssen**
**Um nie wieder Redux verwenden zu müssen**

Das "moderne, einfache Redux" von dem du nicht wusstest, dass du es brauchst. [Poimandres](https://github.com/pmndrs) kann immer vertraut werden. Mit dieser kleinen Bibliothek kannst du alles von Videokonferenz-Apps bis hin zu Spielen und Servern erstellen.

Expand All @@ -26,7 +26,7 @@ Das "moderne, einfache Redux" von dem du nicht wusstest, dass du es brauchst. [P

### Jotai

**Um nie wieder Context zu verwenden zu müssen**
**Um nie wieder Context verwenden zu müssen**

Jotai ist schwer zu schlagen, wenn ein atomarer Ansatz bevorzugt wird. Ebenfalls von [Poimandres](https://github.com/pmndrs). Jotai ermöglicht es dir, Singletons zu definieren, die sich wie globale useState anfühlen. Eine großartige Option für States, die noch nicht eine State Machine benötigen.

Expand All @@ -41,9 +41,9 @@ Die meisten Apps benötigen die gleichen ähnlichen Komponenten - Toggle Buttons

Solche Bibliotheken sind auch bekannt als Headless Libraries. Sie bieten großartige, ungestylte und barrierefreie Komponenten, die du nach deinem Geschmack anpassen kannst. Hier sind ein paar Empfehlungen.

- [Radix UI](https://www.radix-ui.com/) bietet dir ein mächtiges Set an praktischen und barrierefreien primitiven Komponenten, die du mit Vanilla CSS oder Tailwind CSS stylen kannst.
- [Radix UI](https://www.radix-ui.com/) bietet dir ein mächtiges Set an praktischen und barrierefreien primitiven Komponenten, die du mit Vanilla CSS, Tailwind CSS und mehr stylen kannst.

- [Headless UI](https://headlessui.com/) wurde von dem Tailwind CSS Team erstellt und bietet ebenfalls ungestylte, barrierefreie Komponenten, die problemlos mit Tailwind CSS werden können.
- [Headless UI](https://headlessui.com/) wurde von dem Tailwind CSS Team erstellt und bietet ebenfalls ungestylte, barrierefreie Komponenten, die problemlos mit Tailwind CSS verwenden kannst.

- [React Aria](https://react-spectrum.adobe.com/react-aria/) eine große Sammlung an React Hooks um barrierefrei Komponente erstellen zu können. Deren Date Picker ist top.

Expand Down Expand Up @@ -72,7 +72,7 @@ Hier sind unsere Empfehlungen, wenn du du Animationen in deiner App benötigst.

**Für Animationen mit nur einer Zeile Code**

Die meisten Animation Bibliotheken versuchen alle möglichen Anwendungsfälle zu erfüllen und werden dadurch unhandlich. AutoAnimate ist ein Tool ohne Konfiguration, das dir eine signifikanten UX-Verbesserung ohne zusätzlichen Entwickleraufwand bringt.
Die meisten Animations Bibliotheken versuchen alle möglichen Anwendungsfälle zu erfüllen und werden dadurch unhandlich. AutoAnimate ist ein Tool ohne Konfiguration, das dir eine signifikante UX-Verbesserung ohne zusätzlichen Entwickleraufwand bringt.

- [AutoAnimate Homepage](https://auto-animate.formkit.com/)
- [AutoAnimate GitHub](https://github.com/formkit/auto-animate)
Expand All @@ -93,7 +93,7 @@ Framer Motion bietet eine einfache, deklarative Syntax und ermöglicht es dir mi

**Um deine App zu hosten**

Vercel hat das Hosting von Web Apps zu einem Kinderspiel gemacht. Wir haben unsere App auf Hunderttausende von Nutzern hochskaliert und es gab nie Probleme. Getrieben durch AWS und mit einer viel besseren Benutzeroberfläche.
Vercel hat das Hosting von Web Apps zu einem Kinderspiel gemacht. Wir haben unsere App auf Hunderttausende von Nutzern hochskaliert und es gab nie Probleme. Betrieben durch AWS und mit einer viel besseren Benutzeroberfläche.

- [Vercel Homepage](https://vercel.com/)
- [Create T3 App Vercel deployment guide](/en/deployment/vercel)
Expand All @@ -110,15 +110,15 @@ PlanetScale ist die beste "serverless Datenbank Plattform" die wir bisher verwen

**Um deine Infrastruktur zu hosten**

"Das moderne Heroku". Die einfachste Möglichkeit einen echten Server hochzufahren. Wenn Vercel und PlanetScale nicht ausreichen, ist Railway wahrscheinlich die beste Wahl. Einfaach auf ein GitHub Repo zeigen lassen und loslegen.
"Das moderne Heroku". Die einfachste Möglichkeit einen echten Server hochzufahren. Wenn Vercel und PlanetScale nicht ausreichen, ist Railway wahrscheinlich die beste Wahl. Einfach auf ein GitHub Repo zeigen und loslegen.

- [Railway Homepage](https://railway.app/)

### Upstash

**Für serverless Redis**

Wir lieber Prisma und PlanetScale aber manche Projekt benötigte manchmal eine performantere Lösung. Upstash ermöglicht es die in-memory Performance von Redis in deinem serverless Projekt zu nutzen, ohne sich um die Infrastruktur und Skalierung kümmern zu müssen.
Wir lieben Prisma und PlanetScale, aber manche Projekt benötigten manchmal eine performantere Lösung. Upstash ermöglicht es die in-memory Performance von Redis in deinem serverless Projekt zu nutzen, ohne sich um die Infrastruktur und Skalierung kümmern zu müssen.

- [Upstash Homepage](https://upstash.com/)

Expand Down
2 changes: 1 addition & 1 deletion www/src/pages/de/usage/first-steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Solltest du einen anderen Authentifizierungsanbieter bevorzugen, kannst du auch
4. Kopiere die "Client ID" und füge sie in deine `.env` als `DISCORD_CLIENT_ID` ein.
5. Klick "Reset Secret", kopiere das neue Secret und füge den Wert in deine `.env` als `DISCORD_CLIENT_SECRET` ein.
6. Klick "Add Redirect" und gib `http://localhost:3000/api/auth/callback/discord` ein.
- Für den Produktivbetrieb müssen die vorherigen Schritte erneut verfolgt werden, um eine weitere Discord-Anwendung zu erstellen. Ersetze diesmal `http://localhost:3000` mit der URL, auf die du veröffentlichst.
- Für den Produktivbetrieb müssen die vorherigen Schritte erneut verfolgt werden, um eine weitere Discord-Anwendung zu erstellen. Ersetze diesmal `http://localhost:3000` mit der URL, auf die du veröffentlichen möchtest.
7. Speicher die Änderungen.
8. Schreib das `NEXTAUTH_SECRET` in `.env`. Während der Entwicklung funktioniert jeder String. Für den Produktivbetrieb sollte ein Blick auf die Notiz in `.env` geworfen werden, um ein sicheres Secret zu erstellen.

Expand Down
Loading

0 comments on commit 827682b

Please sign in to comment.