Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Improve tech normalization of plural words #252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jackfirth wants to merge 2 commits into racket:master
base: master
Choose a base branch
Loading
from jackfirth:better-tech-keys
Open

Improve tech normalization of plural words #252

jackfirth wants to merge 2 commits into racket:master from jackfirth:better-tech-keys

Conversation

@jackfirth
Copy link
Contributor

@jackfirth jackfirth commented Jul 15, 2020

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.

AlexKnauth and sorawee reacted with thumbs up emoji
jackfirth added 2 commits July 15, 2020 00:12
Motivating use case: `@tech{syntax classes}` should normalize the same as `@tech{syntax class}`.
Copy link
Member

mflatt commented Aug 18, 2020

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.

Copy link
Contributor Author

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?

Copy link
Member

samth commented Jun 23, 2022

We could just generate both tags in the HTML.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /