suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

a round of doc corrections from Gwyth

Browse Source 
original commit: 0b496d5275
This commit is contained in:
Matthew Flatt 2011-03-10 06:34:33 -06:00 committed by Robby Findler
parent fddf8ffbcc
commit f3dab045a8
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
pkgs/racket-doc/scribblings/style/scribble.scrbl
View File

@ -40,7 +40,7 @@ Use the word ``list'' only when you mean a run-time value consisting
of the empty list and cons cells; use the word ``sequence'' in other of the empty list and cons cells; use the word ``sequence'' in other
cases, if you must use any word. For example, do not write that cases, if you must use any word. For example, do not write that
@racket[begin] has a ``list of sub-forms;'' instead, it has a @racket[begin] has a ``list of sub-forms;'' instead, it has a
``sequence of subforms.'' Similarly, do not refer to a ``list of ``sequence of sub-forms.'' Similarly, do not refer to a ``list of
arguments'' in a function call; just write ``arguments'' if possible, arguments'' in a function call; just write ``arguments'' if possible,
or write ``sequence of argument expressions.'' (Unfortunately, or write ``sequence of argument expressions.'' (Unfortunately,
``@tech[#:doc '(lib ``@tech[#:doc '(lib
@ -56,6 +56,8 @@ except that ...,'' instead of abstracting the source and instantiating
it multiple times; often, a prose abstraction is clearer to the reader it multiple times; often, a prose abstraction is clearer to the reader
than a hidden abstraction in the document implementation. than a hidden abstraction in the document implementation.
Hyphenate the words ``sub-form'' and ``sub-expression.''
@section{Typesetting Code} @section{Typesetting Code}
Use @racketidfont{id} or a name that ends @racketidfont{-id} in Use @racketidfont{id} or a name that ends @racketidfont{-id} in
@ -149,6 +151,10 @@ Do not start a sentence with a Racket variable name, since it is
normally lowercase. For example, use ``The @racket[_thing] argument normally lowercase. For example, use ``The @racket[_thing] argument
is...'' instead of ``@racket[_thing] is...'' is...'' instead of ``@racket[_thing] is...''
Use @racket[etc] for ``@|etc|'' when it does not end a sentence, and
include a comma after ``@|etc|'' unless it ends a sentence of is
followed by other punctuation (such as a parenthesis).
@section{Section Titles} @section{Section Titles}
Capitalize all words except articles (``the,'' ``a,'' etc.), Capitalize all words except articles (``the,'' ``a,'' etc.),