Skip to content

Commit

Permalink
Clarify \willintroduce as suggested
Browse files Browse the repository at this point in the history
Co-authored-by: Elena Shmoylova <eshmoylova@users.noreply.github.com>
  • Loading branch information
henrikt-ma and eshmoylova authored Mar 7, 2021
1 parent 1ec3b39 commit 55d370d
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion styleguide.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ As a general rule, `\firstuse` should appear in combination with `\index` for ad
(The use of `\firstuse` instead of just `\emph` helps us both produce consistent formatting and makes it easier to spot cases where the additional use of `\index` has been forgotten.
The reason that `\firstuse` doesn't also do the job calling `\index` is that the form of the term presented to `\firstuse` isn't always in the base form expected in the document index, that there can be a need for special styling tricks in the `\index` argument, etc.)

If the new terminology is used before being introduced, the first use should be marked with `\willintroduce` to alert the reader that this is not a term that is expected to be known yet by a first-time reader.
If the new terminology is used before being introduced, it should be marked with `\willintroduce` (instead of `\firstuse`) to alert the reader that this is not a term that is expected to be known yet by a first-time reader.

## Miscellaneous

Expand Down

0 comments on commit 55d370d

Please sign in to comment.