`margin-note` exceeds page limit in PDF e.g. Racket guide

[spdegabrielle]

What version of Racket are you using?
8.15

What program did you run?
scribble/manual render to pdf

example showing continuation-mark-set->context running beyond edge of page in pdf viewer

page 226
https://download.racket-lang.org/releases/8.15/pdf-doc/guide.pdf

What should have happened?

I'd expect scribble to wrap keep margin notes within gutter by wrapping @racket[continuation-mark-set->context] on hyphens like exn-message in @interaction block on the same page.(see full page capture below).

Not a big issue as manual is intended to be used via browser, but may be frustrating for e-reader users who use PDF. (I was trying to publish print copy via amazon with permission of author)

continuation-mark-set->context

Line 124

@margin-note{The @racket[continuation-mark-set->context] procedure provides best-effort structured backtrace information.}

https://github.com/racket/racket/blob/158361441c0617ee9df91954cf3afbfebc37094a/pkgs/racket-doc/scribblings/guide/control.scrbl#L124

Please include any other relevant details

Interaction block

@interaction[
(with-handlers ([exn:fail?
                 (lambda (v)
                   ((error-display-handler) (exn-message v) v))])
  (car 17))
]

full page

'Gutter' guidance from amazon kindle direct publishing:

Insufficient gutter. Books with 407 pages require at least 0.625" (15.875mm) for the gutter (inside margin) and at least 0.25" (6.35mm) for the outside, top and bottom margins.

[spdegabrielle]

this may be a starting point

% The \refpara command corresponds to `margin-note'. The
% refcolumn and refcontent environments also wrap the note,
% because they simplify the CSS side.
\newcommand{\refpara}[1]{\normalmarginpar\marginpar{\raggedright \footnotesize racket/racket#1}}

scribble/scribble-lib/scribble/scribble.tex

Line 300 in d0a7e55

\newcommand{\refpara}[1]{\normalmarginpar\marginpar{\raggedright \footnotesize #1}}

[spdegabrielle]

https://kdp.amazon.com/en_US/bookshelf

[spdegabrielle]

Would \footnote{ #1} be an acceptable replacement

\newcommand{\refpara}[1]{\normalmarginpar\marginpar{\raggedright \footnotesize #1}}

with

\newcommand{\refpara}[1]{\footnote{ #1}}

My LaTeX is poor and I have not tested this yet

[spdegabrielle]

@sorawee would appreciate your insight?

[sorawee]

I'd also ask @otherjoel and @mbutterick who should know about these better than me.

Personally, I think that's a great workaround. Margin note is nice because of its proximity with the content. But if you need reliable space, I think footnote is great. Many authoring systems that don't support margin note also use footnote as a substitute, so it should be perfectly acceptable. You might also want to eliminate the wide margin space, now that you are not going to use it.

[spdegabrielle]

PR created #481