Some APIs’ desc-riptions start with sentences that don’t summarize their purpose / effects. See e.g. call-with-port from (scheme base). It would be nice to have a reliable synopsis for each entry, which is focused exclusively on describing its purpose in one sentence / line.
An alternative might be to amend the desc-riptions, but I assume that to be a breaking and thus undesirable change.
Some APIs’
desc-riptions start with sentences that don’t summarize their purpose / effects. See e.g.call-with-portfrom(scheme base). It would be nice to have a reliable synopsis for each entry, which is focused exclusively on describing its purpose in one sentence / line.An alternative might be to amend the
desc-riptions, but I assume that to be a breaking and thus undesirable change.