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

Rewrite the first example of the amsmath subsection #73

Open
marmotghost opened this issue Jul 28, 2020 · 5 comments
Open

Rewrite the first example of the amsmath subsection #73

marmotghost opened this issue Jul 28, 2020 · 5 comments
Labels
enhancement New feature or request

Comments

@marmotghost
Copy link

The first example in the amsmath subsection is unfortunate in a few ways. Please consider rewriting it as

\documentclass{article}
\usepackage{amsmath}

\begin{document}
Given  $n,k\geq 0$, solve the recurrence for
\begin{align*}
  Q_{n,0} &= 1   \quad Q_{0,k} = [k=0]\;;  \\
  Q_{n,k} &= Q_{n-1,k}+Q_{n-1,k-1}+\binom{n}{k} \quad\text{for $n$, $k>0$.}
\end{align*}
\end{document}

This avoids the colon before the displayed equations, which is sometimes said to be bad style, and, more importantly introduces spacing before punctuation in formulas in displayed equations. Why is that necessary? Here is why.

\documentclass{article}
\usepackage{amsmath}

\begin{document}
\begin{align*}
  R_{ij'} &= T_{ij},\\
  \widetilde{R}_{ij'} &= \widetilde{R}_{ij}. \tag{bad}
\end{align*}
\begin{align*}
  R_{ij'} &= T_{ij}\;,\\
  \widetilde{R}_{ij'} &= \widetilde{R}_{ij}\;. \tag{better}
\end{align*}
\end{document}

Punctuation close to some formula has repeatedly lead to confusion, e.g. $T_{ij},$ is hard to distinguish from $T_{ij'}$, and there are many more examples of this kind.

@josephwright josephwright added the enhancement New feature or request label Jul 29, 2020
@car222222
Copy link

Maybe more generally the math examples should be carefully scrutinized by a talented math editor?

@josephwright
Copy link
Contributor

Maybe more generally the math examples should be carefully scrutinized by a talented math editor?

Suggestions?

@car222222
Copy link

If the scrutineer must know about so very many things, such as the 'standard conventions' in (some) science and (all?) engineering disciplines and about all typesetting cultures and regimes for abstraction of mathematical input . . .
then no, no suggestions at all!!

@car222222
Copy link

Maybe, along with translations to other languages, we also need translations to each of the many 'languages' that are more commonly called 'the traditions, conventions and trade-craft used by different clans of mathematical authors/editors/typesetters/etc.' ???

@davidcarlisle
Copy link
Member

I suggest we leave this unchanged.

Personally I don't mind the colon before the display.

I have a mild preference for adding space before end of display punctuation, but it is by no means universal practice to add space there. The space commands are the specific subject of the following lesson so adding them at this point would probably need a forward reference and give them more prominence than you want here when the point of the example is alignment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

4 participants