search

rust-analyzer / rust-analyzer.github.io

https://rust-analyzer.github.io/
87 stars 52 forks source link

Alpha status? #155

Closed Aloso closed 2 years ago

Aloso commented 2 years ago

The homepage states:

Note that the project is in alpha status: it is already useful in practice, but can't be considered stable.

This is subjective, but I wouldn't consider ra to be in alpha status: It is very reliable and I haven't had issues due to breaking changes in a very long time.

Furthermore, this paraphraph might sway some people to use the unmaintained RLS extension instead of ra, even though ra is much faster, more reliable and generally better. Therefore I suggest to remove the warning from the home page.

Most people will use ra whether it is stable or not, so the warning isn't that useful: It's informative, but not actionable (due to the lack of a good, stable alternative, except for IntelliJ-Rust which only works in JetBrains products). It would be more useful if the changelogs had a section detailing the breaking changes, though I suspect that it would be empty in most changelogs.

Opinions?

lnicola commented 2 years ago

Agreed, I use rust-analyzer all the time myself :smile:. I think we missed this in https://github.com/rust-analyzer/rust-analyzer/pull/8237. Do you want to file a PR?

It would be more useful if the changelogs had a section detailing the breaking changes, though I suspect that it would be empty in most changelogs.

Uh, sure, we'll try to keep that in mind.

Aloso commented 2 years ago

@lnicola I made a PR.