Open raxod502 opened 3 years ago
Unrelated, but just wanted to note that about an hour ago I actually started to switch over and I am loving it so far!
@raxod502 I agree - it would be good to add a detailed overview and rewrite some sections in a less adversarial tone. The technical criticism stated in the readme should stay though.
I think it makes a lot of sense to recommend a set of related packages, such that it is clear to the user what is needed to get a rich experience - e.g. selectrum/icomplete-vertical+prescient/orderless+marginalia+consult+embark. Also stating that none of the additional packages is actually necessary and they can be added step by step as the user gets more comfortable or depending on custom preferences.
On reading the comment by @alphapapa on Reddit, it became clear to me that the ecosystem of completion packages for Emacs has become very large and potentially difficult to navigate for the new user. I think this listing by @minad speaks for itself in terms of the number of different moving parts:
@tarsius has remarked on Twitter that it's very helpful to see a coherent explanation of how a set of related packages compare to one another, and I think we have a great opportunity to do that here in the Selectrum README.
Currently, we just have a somewhat biased comparative listing of competing packages. I think it would be lovely to rewrite and expand this section to be less adversarial and also explain how different sets of these packages can be used together. This could also subsume the Complementary extensions section, so that we would have one coherent overview of the whole landscape---making it clear which packages are alternatives, and which ones are complementary. If we do a good job, it could probably be helpful to someone even if they decide not to use Selectrum.