From b63e9a4983a7eb21f9a55e5b33eb2d5a8fef6abc Mon Sep 17 00:00:00 2001 From: John Clements Date: Sun, 23 Feb 2020 09:40:20 -0800 Subject: [PATCH] add text on spaces (#3049) Merging this. Please feel free to revert this change if it's not the right thing. --- .../scribblings/style/textual.scrbl | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/pkgs/racket-doc/scribblings/style/textual.scrbl b/pkgs/racket-doc/scribblings/style/textual.scrbl index 989d6ba295..b621860ca9 100644 --- a/pkgs/racket-doc/scribblings/style/textual.scrbl +++ b/pkgs/racket-doc/scribblings/style/textual.scrbl @@ -372,6 +372,26 @@ readability, consider refactoring your program to introduce auxiliary functions so that you can shorten these long blocks of code. If nothing else helps, consider using (potentially) empty comment lines. +In addition, every pair of expressions on a line should have at least one +space between the two, even if they’re separated by parentheses. + +@compare[ + @racketmod[#:file + @tt{good} + racket + + (define (f x g) + [(< x 3) (g (g 3))]) +] + @filebox[@tt{bad} + @codeblock{#lang racket + + (define(f x g) + [(< x 3)(g(g 3))]) + }] +] + + @; ----------------------------------------------------------------------------- @section{End of File}