re: https://github.com/racket/web-server/issues/50
Hi,
I've copied comment on the Continue issue from GitHub because I consider
Continue and important and valuable resource. It is linked from the Racket
home page, I've referred to it many times and continue(Ha!) to do so as I
learn more about
Hi Sorawee,
This is a blight on an otherwise brilliant tutorial. Sadly I don't have
the time to resolve it.
Lacking a clear solution I've added an issue
https://github.com/racket/web-server/issues/50
A short term solution much be to drop @defthing[] and use a monospace font,
maybe using @tt[]?
On Tue, Jan 15, 2019 at 10:04 AM Sorawee Porncharoenwase
wrote:
>
> Yup. This is exactly the proposal I made above, but you stated it far more
> clear :)
Whoops. Insufficient coffee. Sorry!
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To
Yup. This is exactly the proposal I made above, but you stated it far more
clear :)
On Tuesday, January 15, 2019 at 6:50:41 AM UTC-8, Greg Hendershott wrote:
>
> It seems to me that each of those `defthing`s has reasonably good text.
>
> The problem is that the text is in the preceding
It seems to me that each of those `defthing`s has reasonably good text.
The problem is that the text is in the preceding paragraph, instead of
inside `defthing`.
The motivation is it's in "user's guide" style not "reference" style.
But I'd argue these `defthing` forms belong in reference docs
@Matthew, @Stephen: Empty {} won't work because @foo[bar]{} is equivalent
to @(foo bar). Also note that Scribble manual trims whitespace, so you
can't "trick" it by writing @(foo bar " ") (or equivalently @foo[bar]{ })
@John: I agree with you that defthing is not ideal because we don't really
Use @linebreak[]
On Monday, January 14, 2019 at 10:08:49 PM UTC+1, spdegabrielle wrote:
>
>
> is there a way I can force a couple of in scribble? (as a temporary
> measure - I'm not keen to change the scribble/manual, scribble/doc or the
> CSS stylesheets etc.)
>
> Stephen
>
--
You received
Adding a {} after @devthing[...] to get @devthing[...]{} didn't fix the
vertical spacing between the lines.
What I did: @defthing[request-bindings (request? . -> . bindings?)]{}
I took a look at asn1
https://github.com/rmculpepper/asn1/blob/master/asn1-doc/scribblings/types.scrbl
I think the use of defthing here is not really correct; I would argue that if
you’re going to use a defthing, you should go ahead and provide the definition
of the thing. Otherwise, just put in a reference to the name, so that the user
can click through to see the definition. I think that this
I believe the `defthing` tags need an empty {} after them.
> On Jan 13, 2019, at 11:51 PM, Sorawee Porncharoenwase
> wrote:
>
> This seems to be a known and expected output, however. According to
> https://docs.racket-lang.org/demo-manual-m2/Definition_Blocks.html:
>
I’d try change the scribble source `
https://github.com/racket/web-server/blob/master/web-server-doc/web-server/scribblings/tutorial/continue.scrbl`
to make the gaps bigger:
Does that sound ok to you?
I know a better solution would be a stylesheet that better fits the needs
of the Continue
Are you planing to change blockquote class="SVInsetFlow" to introduce the
gap? I think that won't quite work because you don't want to introduce
additional space in the currently correct docs. E.g.,
@defproc[(f) #f]{
hello
}
produces
[image: Screen Shot 2019-01-14 at 01.47.25.png]
which is
12 matches
Mail list logo