scribble icon indicating copy to clipboard operation
scribble copied to clipboard

Improve tech normalization of plural words

Open jackfirth opened this issue 5 years ago • 3 comments

This pull request adjusts the behavior of @tech{} to better handle normalizing plural words to their singular forms. Specifically, it adds a rule to strip a trailing "es" in some circumstances and to not strip a trailing "s" if the last two letters of the term are "ss". I wanted this because @tech{syntax class} and @tech{syntax classes} currently normalize to syntax clas and syntax classe respectively.

jackfirth avatar Jul 15 '20 07:07 jackfirth

My only hesitation here is that this change can break some cross-document references. For example, someone might have rendered a paper that points to documentation at https://docs.racket-lang.org/ on the theory that tag links are stable. I don't know how big of a problem that might be, though. Any thoughts?

I've sometimes had to write things like @tech{syntax class}es to get links to work, so I can certainly appreciate the improvement.

mflatt avatar Aug 18 '20 22:08 mflatt

It's possible. I don't know of a good fix for that problem. But I don't think "we can never change anything about how tag links are created" is an acceptable stalemate. Is there a way we can check that this at least doesn't break any documentation links in existing packages?

jackfirth avatar Aug 19 '20 00:08 jackfirth

We could just generate both tags in the HTML.

samth avatar Jun 23 '22 17:06 samth