Skip to content

Generate deprecation docs for types like we do for commands#1038

Open
MarijnS95 wants to merge 1 commit into
masterfrom
type-deprecation-docs
Open

Generate deprecation docs for types like we do for commands#1038
MarijnS95 wants to merge 1 commit into
masterfrom
type-deprecation-docs

Conversation

@MarijnS95

Copy link
Copy Markdown
Collaborator

When handling the new <deprecate> element where new <feature>s and <extension>s can deprecate earlier functionality with an explanation link, these links were only forwarded to commands but not types (only defines). Forward it so that it's also readable for the user.

When handling the new `<deprecate>` element where new `<feature>`s and
`<extension>`s can deprecate earlier functionality with an explanation
link, these links were only forwarded to commands but not types (only
defines).  Forward it so that it's also readable for the user.
@MarijnS95

Copy link
Copy Markdown
Collaborator Author

On a side-note, someone mentioned to me to keep the deprecated attributes, but behind a cfg_attr. I think perhaps a feature = "pedantic_deprecated" could help users find where they're not using the utmost latest Vulkan features, if that's the sort of thing they're interested in and want some help with, without affecting other kinds of users?

@Ralith

Ralith commented May 6, 2026

Copy link
Copy Markdown
Collaborator

I think perhaps a feature = "pedantic_deprecated" could help users find where they're not using the utmost latest Vulkan features, if that's the sort of thing they're interested in and want some help with, without affecting other kinds of users?

That makes sense to me! I'd personally find it useful, while we shouldn't be forcing it on everyone.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants