nicoburns / blessed-rs

A community guide to the Rust ecosystem
https://blessed.rs
1.17k stars 66 forks source link

Page information is outdated and sometimes misleading #116

Open eirnym opened 2 months ago

eirnym commented 2 months ago

Thank you for an effort to create this list.

However, I have a few points to address:

  1. Page don't need to contain rust source. Whole page can be simplified to page generated from AsciiDoc sources with a custom CSS.
  2. Page information contains many claims without any source links, co these claims can't be trusted. If information had been taken from an issue, issue link must be provided, if an article, lemmy, mastodon or another source, the same. 1.page information contains no version information for projects, thus it's hard to say if claim is true or false at time of reading.
  3. At the time of writing lib.rs and crates.io contain way more libs and tools on each topic, some of them could be added manually to the list.
  4. I hope this page is populated not only by issues but also checked manually from time to time. It would be misleading if not (see point about claim sources).
djc commented 2 months ago

Which information specifically is outdated or misleading?

eirnym commented 2 months ago

There's a lot personal opinions like this one without an explanation of any reasons.

A smaller, simpler library. Preferrable if covers your needs, but it's quite limited in what it provides

Or It's not the fastest without any benchmark link.

Or not well maintained without any explanation whatsoever.

Or However development has been intermittent, and the async branch still doesn't have a stable release. Use of rocket is not recommended until this has been fixed.

And so on and so forth

djc commented 2 months ago

As the site mentions, it is unofficial. The data reflects the opinion of the author (which usually will reflect a shared sentiment in the community).

If you want to contribute, I'd suggest filing issues or submitting PRs for specific language you think is outdated, misleading or could be better substantiated, ideally with suggestions for how to improve it.

eirnym commented 2 months ago

Even this is a personal opinion, I'd like to have support for each claim as I want to be aware of a specific issue and maybe support a project/library I like by investigating reasons or by fixing a problem.

also I don't accept "this is slower" without a proper benchmark between different implementations.

nicoburns commented 2 months ago

The whole point of blessed.rs is to be opinionated. It would indeed be better if such opinions could be backed by data and facts but:

  1. Not everything has an objective answer. Sometimes one has to pick subjectively.
  2. As the primary maintainer of this website I don't have the time or energy to justify every opinion.

This project is intentionally open source, and we do accept community contributions (including improvements to the content) so if you have any objections to specific wording, suggestions for changes, or would like to provide (or even ask for) justification for specific claims then please feel free to open an issue or pull request.

eirnym commented 2 months ago

I'd start with what it's possible and relatively easy to confirm. If there's a personal or unconfirmed, I'd used a format as wikipedia did (citation needed).