za419 / CadenceBot

A Discord bot for Cadence Radio
MIT License
2 stars 1 forks source link

README.md distillation #114

Closed kenellorando closed 1 year ago

kenellorando commented 1 year ago

This PR changes the README.

I argue that a new user's number one desire is easy installation. I've realized that what most users solely care about is how to "use" the project. They want to derive value as fast and as easily as possible. To do this, they'll take ten seconds skimming the README to get a feeling of how much time it would take to do it.

@za419's latest change to the README was a definite improvement, especially with the addition of some new illustrations. CadenceBot isn't actually complex to install at all, but I think the remaining text still makes it look daunting. If our goal is to onboard more users, we should distill as purely as possible to what the installing user needs to know. We should classify everything else as non-essential to the first-time user and move it to the GitHub Wiki.

I took these principles from Cadence's repo and applied them here:

If acceptable, I expect @za419 to make additional changes as he sees fit. I might have messed up some of the steps or distilled too much. Merging of this PR would also require any "removals" to be migrated by @za419 into another documentation location, and to fill in the empty URL links that I suggested in square brackets.

kenellorando commented 1 year ago

The latest update adds the implementation and development details back in, in <details>.