diff --git a/assets/css/app.css b/assets/css/app.css index acaa4508..c22e3dad 100644 --- a/assets/css/app.css +++ b/assets/css/app.css @@ -327,31 +327,56 @@ select.select { text-decoration: underline; } -/* API docs page — narrower reading column, since the site font is - monospace and monospace prose is uncomfortable past ~80ch. */ +/* API docs page — readable prose. Override the project's monospace + default with a system sans stack for the body, keep mono for code + spans and pre blocks. Without this the bulleted prose wraps to + 2-3 lines per item and is a chore to scan. */ .markdown-content.api-docs { - max-width: 60rem; - font-size: 0.95rem; + max-width: 64rem; + font-family: + -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, + Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji"; + font-size: 1rem; + line-height: 1.7; +} + +.markdown-content.api-docs code, +.markdown-content.api-docs pre, +.markdown-content.api-docs pre code { + font-family: "Cascadia Code", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; } .markdown-content.api-docs code { word-break: break-word; + font-size: 0.875em; } .markdown-content.api-docs h1 { - font-size: 1.75rem; + font-size: 2rem; + letter-spacing: -0.01em; } .markdown-content.api-docs h2 { - font-size: 1.3rem; + font-size: 1.5rem; + letter-spacing: -0.01em; + margin-top: 2.25rem; } .markdown-content.api-docs h3 { - font-size: 1.1rem; + font-size: 1.2rem; + margin-top: 1.75rem; +} + +.markdown-content.api-docs h4 { + font-size: 1rem; +} + +.markdown-content.api-docs li { + margin: 0.4rem 0; } .markdown-content.api-docs table { - font-size: 0.85em; + font-size: 0.95em; } .markdown-content.api-docs th,