Skip to content

update typing-features and faqs#3335

Merged
sharkdp merged 1 commit intomainfrom
cjm/gradual
Apr 27, 2026
Merged

update typing-features and faqs#3335
sharkdp merged 1 commit intomainfrom
cjm/gradual

Conversation

@carljm
Copy link
Copy Markdown
Contributor

@carljm carljm commented Apr 25, 2026

Closes #3266.

This updates our typing-features and typing-faq docs to account for recent changes in ty's behavior. Both the "gradual guarantee" and "fixpoint iteration" sections no longer describe our actual behavior. In both cases, I tried different ways to update the section, but ended up feeling like there was nothing that distinctive or interesting to say, so I just removed the sections entirely.

For gradual guarantee, I don't think we should have a section with that name, since in general we don't take that as a guiding principle anymore. The remaining singleton case is very niche, and already discussed in the FAQ.

For fixpoint iteration, we still do that of course, but for performance reasons we have since decided to promote literal unions much more quickly in all cyclic cases. So I wasn't able to construct any realistic case anymore where this "union of literals up to some limit" behavior is visible.

@carljm carljm requested a review from sharkdp April 25, 2026 22:51
@AlexWaygood AlexWaygood added the documentation Improvements or additions to documentation label Apr 25, 2026
Copy link
Copy Markdown
Contributor

@sharkdp sharkdp left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@sharkdp sharkdp merged commit d451af4 into main Apr 27, 2026
15 checks passed
@sharkdp sharkdp deleted the cjm/gradual branch April 27, 2026 08:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update the "gradual guarantee" section in the docs

3 participants