diff --git a/collects/scribblings/scribble/how-to.scrbl b/collects/scribblings/scribble/how-to.scrbl index cee2c9a9..2e66bd9e 100644 --- a/collects/scribblings/scribble/how-to.scrbl +++ b/collects/scribblings/scribble/how-to.scrbl @@ -283,11 +283,11 @@ manual: @(require scribble/manual (for-label scheme)) @(define ref-src - '(lib "scribblings/reference/reference.scrbl"))] + '(lib "scribblings/reference/reference.scrbl")) @title{My Library} - See also @italic{@secref[#:doc reference-src]{pairs}}. + See also @italic{@secref[#:doc ref-src]{pairs}}. EOS ] diff --git a/collects/scribblings/scribble/style.scrbl b/collects/scribblings/scribble/style.scrbl index 01d1c04d..388b406e 100644 --- a/collects/scribblings/scribble/style.scrbl +++ b/collects/scribblings/scribble/style.scrbl @@ -103,3 +103,7 @@ for quotation marks that are part of code. Do not use a citation reference (as created by @scheme[cite]) as a noun; use it as an annotation. + +Do not start a sentence with a Scheme variable name, since it is +normally lowercase. For example, use ``The @scheme[_thing] argument +is...'' instead of ``@scheme[_thing] is...''