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

Deprecation language in docs is not clear. #2222

Open
JSandusky opened this issue Jul 8, 2024 · 1 comment
Open

Deprecation language in docs is not clear. #2222

JSandusky opened this issue Jul 8, 2024 · 1 comment
Labels
support-request A request for help from the community

Comments

@JSandusky
Copy link

JSandusky commented Jul 8, 2024

What are you trying to do?
Documentation description of intent to later deprecate is ambiguous.

Docs read: x64: Alias for x86_64; There is intent to deprecate this

Which one? x64 alias will be deprecated or the x86_64 specifier will be deprecated and x64 will take its' place?

@JSandusky JSandusky added the support-request A request for help from the community label Jul 8, 2024
@samsinsane
Copy link
Member

Are you referring to the architecture docs?

value is one of:

  • [...]
  • x86
  • x86_64
  • [...]

Additional values that are aliases for the above:

  • [...]
  • x32: Alias for x86; There is intent to deprecate this
  • x64: Alias for x86_64; There is intent to deprecate this

I'm not sure I agree about the ambiguity - if we intended to deprecate x86 or x86_64 those lines would contain the deprecation notice not the x32 and x64 lines. However, I think the action to be taken here is to just remove the deprecation comments until the deprecation actually occurs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
support-request A request for help from the community
Projects
None yet
Development

No branches or pull requests

2 participants