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

📚 Docs pages reflect unreleased features without flagging them as pre-release #1058

Open
1 task done
benjamincburns opened this issue Sep 5, 2024 · 1 comment
Open
1 task done

Comments

@benjamincburns
Copy link

Documentation URL

https://biomejs.dev/linter/rules/use-import-extensions/#options

Description

The link in question documents a feature that is not yet part of a stable release. This just tripped me up, as it describes a feature that I need, and I'm using the latest release, but the recommended config is failing to validate.

It'd be fine if the docs included pre-release functionality, provided that the portion of the docs that reflect items that aren't in the stable build were flagged as pre-release. Unfortunately, at the top of the page it indicates that the feature has been available Since: v1.8.0, which is especially misleading when portions of the page describe enhancements that haven't been released yet.

Expectations

The docs page would either describe the latest stable release, or in cases when details about pre-release functionality are included, there would be some indication that the functionality in question is only available via a pre-release/nightly build.

Code of Conduct

  • I agree to follow Biome's Code of Conduct
@benjamincburns
Copy link
Author

Just to make it extra annoying, due to biomejs/biome#3804, I also can't use this feature via the nightly... 😞

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

1 participant