# Help:Editing/House Style/Linguistic Style

## Linguistic Style

### Language

This is an English language website, and so all pages are to be presented in English.^{[1]} Where there is a difference between spellings between US and rest-of-world English, the US version is generally used, with a few exceptions (the spelling of metre is under discussion).

### Linguistic Style

During the presentation of a mathematical argument, a formal style is preferred.

For example:

*Suppose that ...*

is preferred to:

*Let's suppose that ...*

and:

*Hence the result.*

is preferred to:

*... and we're done.*

As an attempt is being made for $\mathsf{Pr} \infty \mathsf{fWiki}$ to appeal to as wide an audience as possible worldwide, using colloquial language (except for example when illustrating logical concepts by means of everyday examples) is discouraged.

### "Let" and "Suppose"

It is preferred that "Let" is used to introduce the existence of an entity in an argument, as follows:

- Let $S$ be a set.

- Let $x, y \in S: x \ne y$.

- $\ldots$

However, when introducing an entity whose existence is in question (for example, when constructing a Proof by Contradiction), the word "Suppose" is recommended:

- Suppose $T \subseteq S$ such that $\card T > \card S$.

- $\ldots$

### "Any"

The word "any" can be ambiguous.

It is recommended that it not be used.

Instead, consider whether "every" or "an arbitrary" can be used instead.

### Abbreviations

The difference between "e.g." (*exempli gratia* - for example) and "i.e." (*id est* - that is) is sadly falling into obscurity. It is all too common for "i.e." to be used when "for example" is meant, and vice versa.

So as to remove all confusion, such abbreviations are discouraged.

Also, beware the ubiquitous confusion between *its* and *it's*. The full version *it is* should be used instead of *it's* in any case, so *it's* should have no reason to appear.

### Sentence Length

During the course of an argument to present a mathematical proof, follow these rules:

- Each sentence should be short.

- Each sentence should convey one step, either:
- One simple statement, or:
- One compound statement of the form:
*$P$, therefore $Q$*.

- Each sentence should be on a separate line.

Compare the presentations:

$(1):$

*$S$, because of $R$ (we know this from Tom's Theorem), because of $Q$ (from above) which applies when $P$ holds (see Fred's Theorem), but we know $P$ holds because it's what we defined in the first place.*

$(2):$

- Let $P$ hold.
- From Fred's Theorem, it follows that $Q$.
- From above, $R$.
- From Tom's Theorem, $S$.

The following is an example of the style of mathematical exposition which we believe has no place in $\mathsf{Pr} \infty \mathsf{fWiki}$, and indeed, the entire universe:

*The ($\implies$) is shown just the same as above, while the other direction easily follows, since $\MM$ satisfying the condition that for every $\LL$-formula $\map \phi {x, \bar v}$ and for every $\bar a$ in $\MM$, if there is an $n$ in $\NN$ such that $\NN \models \map \phi {n, \bar a}$, then there is an $m$ in $\MM$ such that $\NN \models \map \phi {m, \bar a}$, is closed under functions (by directly applying the condition to formulae of the form $\map \phi {x, \bar y} = \paren {x = \map f {\bar y} }$), and hence the universe of a substructure, which reduces it to the statement above.*

#### Parenthetical Notes

It is often tempting to slide some further information or explanation into the middle of a sentence by slipping it into parenthesis.

It is **highly recommended** that this practice be avoided as far as possible.

Not only does this clash with the $\mathsf{Pr} \infty \mathsf{fWiki}$ house style of short, simple sentences, but also can cause confusion when the parenthesized material contains similar mathematical notation:

- Let $\map {f_n} x \in \Sigma$ (where $\map {f_n} x$ is a family (indexed by $\map I \alpha$) of functions in $\struct {\Sigma, \mu}$) be a function such that ...

So please don't do this.

A similar stylistic presentation to be avoided is the following

- The supremum of $f$, $\map \sup f$, is defined as:
- $\map \sup f = \map \max {\Img f}$

It is clear from the line following that $\map \sup f$ is how the supremum of $f$ is denoted, so there is no need to include it as a parenthetical explanation in the first line.

This is preferred:

- The supremum of $f$ is defined as:
- $\map \sup f = \map \max {\Img f}$

If you are uneasy about the ability of the reader to make that connection, feel free to write something like:

- The supremum of $f$ is defined and denoted as:
- $\map \sup f = \map \max {\Img f}$

### Filler Words

Whether or not filler words are needed (*it follows that*, *we have*, *hence* etc.) is a stylistic decision. Fewer words are preferred, but clarity and completeness override every other consideration.

The general approach is to try to use as terse a form as possible.

Compare:

- We have that the ordinal subset of an ordinal is an initial segment of it, so it follows that:

with:

The latter form is preferred.

### Empty Statements and Waffle

It is tempting to fill a page up with statements that do not actually impart any information, but which make the author look and feel good.

Such are to be avoided.

Examples:

*The first part of the proof is easy.*

*We mention for the interested reader ...*

See also the templates `{{handwaving}}`

and `{{explain}}`

.

This article is complete as far as it goes, but it could do with expansion.There are plenty more -- these will be added as they are encountered.You can help $\mathsf{Pr} \infty \mathsf{fWiki}$ by adding this information.To discuss this page in more detail, feel free to use the talk page.When this work has been completed, you may remove this instance of `{{Expand}}` from the code.If you would welcome a second opinion as to whether your work is correct, add a call to `{{Proofread}}` the page. |

## Capital Letters begin Sentences

This is raised as a particular point, because it crops up over and over again.

The sentence form in question is:

- Let (such-and-such) hold, where (so-and-so) means (thus and so).

When (such-and-such) is a statement in mathematical symbols, placed on its own line (as per house style recommendations), the temptation is to present the above sentence as:

- Let:
- $\ds S = \sum_{i \mathop \in \N} \frac 1 {2^i}$

- Where $\ds \sum$ denotes summation.

Just because it starts a new line does *not* mean that "where" is to be written with a capital W. It is the continuation of the previous sentence, which just happens to have, as part of its main clause, a mathematical expression.

It should be:

- Let:
- $\ds S = \sum_{i \mathop \in \N} \frac 1 {2^i}$

- where $\ds \sum$ denotes summation.

Breaking this linguistic rule can lead to confusion, especially when the "where" clause starts to get complicated:

- Let:
- $\ds S = \sum_{j \mathop \in \N} \lim_{x \mathop \to \infty} \cos j x + i \sin j x$

- Where $\ds \sum$ denotes summation and $\lim$ is the limit as $x$ tends to infinity and:
- $\cos j x + i \sin j x = e^{ijx}$

In the above, the reader, thinking that "where" starts the next sentence, and therefore a new thought, is left wondering:

- "Where this applies, and that means that, and this ... then what?"

whereas in fact the only reason for the "where" clause is to amplify the sense of the expression above it.

Similarly:

\(\ds x \in A \cap \paren {B \cap C}\) | \(\leadstoandfrom\) | \(\ds x \in A \land \paren {x \in B \land x \in C}\) | By definition of Set Intersection | |||||||||||

\(\ds \) | \(\leadstoandfrom\) | \(\ds \paren {x \in A \land x \in B} \land x \in C\) | Rule of Association: Conjunction | |||||||||||

\(\ds \) | \(\leadstoandfrom\) | \(\ds x \in \paren {A \cap B} \cap C\) | By definition of Set Intersection |

In the above, the "by definition" phrases in the comment column should not start with a capital letter, as they continue the "sentence" started on the left.

Thus the above structure is better rendered as:

\(\ds x \in A \cap \paren {B \cap C}\) | \(\leadstoandfrom\) | \(\ds x \in A \land \paren {x \in B \land x \in C}\) | by definition of Set Intersection | |||||||||||

\(\ds \) | \(\leadstoandfrom\) | \(\ds \paren {x \in A \land x \in B} \land x \in C\) | Rule of Association: Conjunction | |||||||||||

\(\ds \) | \(\leadstoandfrom\) | \(\ds x \in \paren {A \cap B} \cap C\) | by definition of Set Intersection |

Better still, lose the redundant filler-word "by", and render the entire structure elegantly as:

\(\ds x \in A \cap \paren {B \cap C}\) | \(\leadstoandfrom\) | \(\ds x \in A \land \left({x \in B \land x \in C}\right)\) | Definition of Set Intersection | |||||||||||

\(\ds \) | \(\leadstoandfrom\) | \(\ds \paren {x \in A \land x \in B} \land x \in C\) | Rule of Association: Conjunction | |||||||||||

\(\ds \) | \(\leadstoandfrom\) | \(\ds x \in \paren {A \cap B} \cap C\) | Definition of Set Intersection |

Now, as there is no filler-word "by", the comment is no longer implicitly part of a sentence, and so the comment is a standalone label which now merits an uppercase presentation.

Here, note that a further evolutionary step has been made: to replace the code `Definition of [[Definition:Set Intersection|Set Intersection]]`

with the template construct `{{Defof|Set Intersection}}`

for further streamlining of the source.

## References

- ↑ Suggestions have been made as to how we may go about the exercise of internationalization, but progress in that direction is slow due to its perceived low priority.