Skip to content
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

Documentation of "polymorphic" variants is misleading #4753

Closed
vicuna opened this issue Mar 20, 2009 · 1 comment
Closed

Documentation of "polymorphic" variants is misleading #4753

vicuna opened this issue Mar 20, 2009 · 1 comment
Assignees

Comments

@vicuna
Copy link

vicuna commented Mar 20, 2009

Original bug ID: 4753
Reporter: @damiendoligez
Assigned to: @garrigue
Status: closed (set by @garrigue on 2010-04-27T07:08:56Z)
Resolution: fixed
Priority: normal
Severity: minor
Version: 3.11.0
Fixed in version: 3.12.0+dev
Category: documentation
Related to: #4803

Bug description

Everyone calls them "polymorphic variants", but the documentation calls them "variants".
To many people, that term evokes the constructors or values of regular concrete types.

In order to remove the ambiguity, I think we should rename them to something like
"open variants" or "dynamic variants".

@vicuna
Copy link
Author

vicuna commented Apr 27, 2010

Comment author: @garrigue

Disambiguated the meaning of "variant" by adding polymorphic wherever necessary (hopefully).
There are still a number of non-qualified or differently qualified cases, to avoid overly heavy
language, but they should be only left in paragraph clearly marked as concerning polymorphic
variants.

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

No branches or pull requests

2 participants