Guidelines for translation – Serlo

Guidelines for translationBearbeiten

Translation styleBearbeiten

  • Capital letters in titles: Like on Wikipedia, we suggest to only capitalize the first word of a page or section title (like "Real numbers" instead of "Real Numbers" or "real numbers")
To-Do:

Collect some more guidelines

ContentBearbeiten

  • If you come up with new explanations or solutions to exercises, you are invited to add them in the English version.
  • You are also invited to upload your own figures if you feel they are needed. Use the upload wizard to put your figure online and after uploading, embed a link to the figure in the corresponding article.
  • Some German articles contain German media content (e.g. videos). you may just leave them in place and add a note like (in German) in the captions. Those videos will be replaced later.
  • There are German articles (A) which embed parts of other German articles (B) - so if you click in (A) on "edit" to translate, you will just find a link to (B), but no translatable text. The trick is to follow the link to (B), where you can copy the source code (containing the translatable text) by clicking on "edit" in (B). Insert the source code in the English version of (A) and you can start translating.
  • German expressions in formulas can and should be translated (like   für alle   is changed to   for all  )


Mathematical conventionsBearbeiten

The following mathematical conventions are a translation of this German article. New conventions and changes are usually published there first and it might take some time for them to be translated, so that article should be treated as the master document.

Notation of sequencesBearbeiten

For sequences we use the notation  . The source code to produce this is \left(a_n\right)_{n\in\N}. For sequence elements we write  , not   (cf. this survey (in German))

Natural numbersBearbeiten

We understand   (so zero is not regarded as a natural number). If you want to refer to the set  , you should use  . (cf. this survey (in German))

Imaginäre EinheitBearbeiten

The imaginary unit is written as \mathrm{i}. Appearance:  

SubsetsBearbeiten

We denote subsets with \subseteq, for example  . For proper subsets we use  , e.g.  . We do not use the notation  . There is an extended discussion of this convention (in German).

Disjoint unionsBearbeiten

We denote the disjoint union of sets as  .

Column vectorsBearbeiten

In running text we write   for column vectors (LaTeX code: (1,2,3)^T). In an equation environment we use the common notation   (LaTeX code: \begin{pmatrix} 1 \\ 2 \\ 3 \end{pmatrix}). The reason is that actual column vectors used in running text exceed line height by far and mess up the formating (take this text as an example). Therefore we try to avoid them in running text. Cf. this survey (in German) for the decision.

Beispiel:

This is running text, so I write <math>(1,2,3)^T</math>. In an equation environment I instead use

{{Formel|<math>2 \cdot \begin{pmatrix} 1 \\ 2 \\ 3 \end{pmatrix} = \begin{pmatrix} 2 \\ 4 \\ 6 \end{pmatrix}</math>}}

Ergebnis:

This is running text, so I write  . In an equation environment I instead use

 

Linear span / hull of vectorsBearbeiten

The linear span of a set   of vectors is denoted  . Source code: \operatorname{span}(M) (link to survey (in German)).

Transformation matrixBearbeiten

The transformation matrix of a linear map   is written  , where   is the basis of the source vector space, while   is the basis of the target vector space. Source code: M_C^B(L)

Ordered basisBearbeiten

We do not have any special notation for ordered bases. You should explain in running text, whether a basis is ordered or not.