-
Notifications
You must be signed in to change notification settings - Fork 1
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
Feature/ns cs translation #5
base: master
Are you sure you want to change the base?
Conversation
It would be nice to preserve both translations. |
Sieht schon mal ganz gut aus.
|
Ich fände es gut, beide Sprachvarianten zu haben und schlage vor die deutsche Git-Spickzettel zu nennen. |
Die Quellenangabe am Ende, die zwar richtig ist, ist dennoch ein wenig verwirrend, da sie keine wirklich hilfreichen Infos über uns enthält. Ich schlage deshalb vor wenigstens die Url des Repos einzufügen. |
Der "Fehler mit deprecated \tt" ist mit dem commit nicht repariert, wenn dann müsste in der ersetzung \texttt{#1} stehen. So verändert das das Kompilat. |
Beide Sprachvarianten beizubehalten finde ich auch besser. Dann muss man nur einen Prozess etablieren, der sicherstellt, dass Änderungen immer Parallel an beiden stattfinden. Vorschlag: Anmerkung: Man sollte den "Inhalt" in zwei Dokumente importieren, die das \ende Kommando entsprechend implementieren und das korrekte babel importieren (just in case, eigentlich sollte es keine Zeilenumbrüche geben, da kein Blocksatz auf den Folien ist). Der Rest der Präambel sollte im eingefügten Dokument sein (Pakete für die farbigen Blöcke, etc.), so dass die Code-Duplikation minimiert ist. Aufwändigere Alternative: Einen "Translation"-Marker verwenden und mit einem externen Tool die Übersetzungen generieren (so wie das in GUI Toolkits/mit gettext gemacht wird), das skaliert besser, wenn wir mal mehr Sprachen unterstützen wollen. Fertiges tooling dafür: getTeXt. |
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.
Abgesehen von den Bereits angemerkten Punkten, dass es ganz nett wäre beide Sprachen parallel zu pflegen habe ich noch die untenstehenden Anmerkungen.
Mindestens der auskommentierte Teil sollte auf keinen Fall im Hauptbranch landen.
\documentclass[a4paper,fontsize=7.5pt]{scrreprt} | ||
%\documentclass[a4paper,fontsize=7.5pt, ngerman]{scrreprt} |
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.
Das auskommentierte Zeug gehört da nicht hin.
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.
Ja, das ist ein Überbleibsel vom Debuging des behobenen \tt
Errors
|
||
% Packages | ||
\usepackage[utf8]{inputenc} | ||
%\usepackage[ngerman]{babel} | ||
%\usepackage[]{babel} |
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.
Siehe oben.
Und warum weder ngerman noch english?
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.
Sind beide wieder drin.
@@ -66,7 +69,7 @@ | |||
% set own shortcuts | |||
\newcommand{\sourcetext}[1] { | |||
\begin{tabularx}{\hsize}{X} | |||
{\tt #1} | |||
{\texttt{} #1} |
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.
\texttt{}
tut garnichts, warum steht das da?
\cmdline{git config [-{}-global] [option]} | ||
\annotation{with \texttt{-{}-global} it is stored in \texttt{$\tilde{\ }$/.gitconfig}} | ||
\subsection{Information about the user} | ||
\annotation{mit \texttt{-{}-global}: wird es gespeichert in \texttt{$\tilde{\ }$/.gitconfig}} |
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.
"mit […] wird es in […] gespeichert" liest sich flüssiger als "mit […] wird es gespeichert in […]".
\sourcetext{color.ui auto} | ||
\subsection{Improve interactive user-experience} | ||
\subsection{Verbesserung der interaktiven Nutzererfahrung} |
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.
Versteht das unser Zielpublikum?
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.
Wäre "Verbesserung der interaktiven Bedienbarkeit" besser?
\cmdline{git add path/to/add} | ||
\subsection{Interactively select changes for addition/committing} | ||
\subsection{Wähle interaktiv alle Änderungen zum Hinzufügen/ Committen aus} |
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.
Kein Leerzeichen nach dem Schrägstrich.
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.
Erledigt
\cmdline{git commit -m "<message>"} | ||
} | ||
|
||
%% How to handle branches | ||
\colouredbox{orange}{ | ||
\begin{center}\section{Working with Branches}\end{center} | ||
\subsection{List all branches} | ||
\begin{center}\section{Arbeiten mit Branches (dt.: Äste)}\end{center} |
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.
"Zweige" anstatt "Äste" vielleicht? Das ergibt mehr Sinn, weil "Zweig" auch in sowas wie "Abzweigung" drin steckt.
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.
+1 für Zweig. Wir haben das Wort Zweig auch als deutsches Synonym zu Branch im Workshop eingeführt.
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.
Die Argumentation finde ich nachvollziehbar auch wenn ich eigentlich "Zweig" mit "twig" übersetzen würde.
\cmdline{git checkout <branch>} | ||
\subsection{Merge Branch B1 into B2} | ||
\subsection{Branch B1 in B2 mergen (dt. mischen)} |
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.
"Zusammenführen" ist finde ich eine bessere Übersetzung als "Mischen". Zusammenführen drückt mehr aus, dass das mit System passiert, und nicht chaotisch.
\annotation{generates commit even if fast-forwarding is possible} | ||
\subsection{Create Branch based on HEAD and checkout} | ||
\annotation{Erstelle einen Commit auch wenn fast-forwarding möglich ist} | ||
\subsection{Erstellen eines Branches basierend auf HEAD und checkout} |
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.
"und wechselt zu diesem" anstatt "und checkout"
\cmdline{git push [origin] [branch]} | ||
\subsection{Create tags} | ||
\subsection{Einen tag (dt.: ???) erstellen} |
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.
Einfach bei "Tag" belassen, deutsche Übersetzung weglassen. "Tag" ist ja ein relativ eingedeutschter Begriff heutzutage. #thankstwitter
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.
Ich bin für das Genus Neuter für "Tag" (unter anderem um es von "der Tag" zu unterscheiden), der Duden ist meiner Meinung.
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.
Grummelgrummel, jaja… Damit werde ich mich nicht anfreunden können ;-).
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.
Ich bin dafür es mir Fragezeichen zu belassen. Schließlich ist es work-in-progress und Mitmachen erwünscht.
So, ich habe den Pullrequest auf den Masterbranch umgestellt. Bitte umsichtig mergen, damit nichts verlorengeht! Bitte für die Zukunft: Es wäre hilfreich, wenn erst alle Pullrequests von Unterbranches durchgeschaut (geschweige denn gemerged) würden, bevor mit Master oder so gemerget wird. |
Halte ich nicht unbedingt für sinnvoll. Wenn es extrem wichtig ist, sollte man das vielleicht eher am PR für den Targetbranch anmerken, für Sichtbarkeit (und vielleicht durch ein Request Changes review deutlich markieren). Ansonsten spricht doch garnichts gegen Ändern vom Zielbranch im Zweifelsfall? (Ein anderes Vorgehen was ich sonst noch kenne, ist, den PR immer gegen master aufzumachen und anzusagen, dass die Änderungen von PR #soundso abhängen und vorher nicht gemergt werden sollte.) |
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.
So, schaut mal was ihr hiervon haltet.
\documentclass[a4paper,fontsize=7.5pt]{scrreprt} | ||
%\documentclass[a4paper,fontsize=7.5pt, ngerman]{scrreprt} |
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.
Ja, das ist ein Überbleibsel vom Debuging des behobenen \tt
Errors
|
||
% Packages | ||
\usepackage[utf8]{inputenc} | ||
%\usepackage[ngerman]{babel} | ||
%\usepackage[]{babel} |
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.
Sind beide wieder drin.
\cmdline{git add path/to/add} | ||
\subsection{Interactively select changes for addition/committing} | ||
\subsection{Wähle interaktiv alle Änderungen zum Hinzufügen/ Committen aus} |
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.
Erledigt
Gebaute PDF im git ist eine sehr schlechte Idee: Das macht das Repo unnötig groß und muss bei jeder Änderung angepasst werden und ist daher anfällig für Inkonsistenz, wenn wir eine gebaute Version verbreiten wollen, dann über's Wiki (da sollte man dann natürlich auch jeweils die neuste Version hochladen, wenn man was ändert, aber wenigstens ist es dann nicht innerhalb des Repositories Inkonsistent). Delta-Conpression funktioniert auch wirklich nicht gut für PDF. |
Translated the Git cheat-sheet into german.