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

Discussion: consider removing libraries' links from spec readme #81

Open
thunderbiscuit opened this issue Feb 6, 2024 · 1 comment
Open
Labels
documentation Improvements or additions to documentation

Comments

@thunderbiscuit
Copy link
Collaborator

thunderbiscuit commented Feb 6, 2024

After speaking with @ngutech21 over a dev call last week, I decided to open an issue to discuss the value of the links to the libraries that implement the NUTs in the README.

My thinking is the following: links to individual libraries that implement the cashu protocol are important, but belong elsewhere than the spec (main website? awesome list? other places?). Here are a few reasons why I think over time it gets harder and harder to keep those in sync, and how they somehow complicate the commit history of the spec repo without reason.

  1. It used to be just a few libraries, but now there are a lot more! It's a lot of links. Keeping them up to date is messy and likely to always be slightly behind.
  2. Some of the libraries in the list did implement certain NUTs, but might not have updated to the v1 endpoints. What does that mean for the links? Should we remove them? Until they implement them, and then bring them back?
  3. What happens when libraries become unmaintained?
  4. There is a feeling (for me at least) that the spec is a rather static document(s) that moves slowly and cautiously. For the links in the readme to be valuable, they need to be quite opposite this, and be evergreen/changing. The two might be better if they are separated.
  5. Reading the commit history of the spec is partially "polluted" by commits that simply add/remove links to new or outdated libraries in the readme. These commits don't impact the spec itself; it'd be good to have few of them.

Now I think the readme should point to locations where developers would be able to find that sort of information, but that could be just a new section with some meta links, or maybe just a sentence like You can find a list of libraries that implement the various NUTs in this spec at [this link] and [this link].

Anyway just a thought as the spec matures.

@thunderbiscuit thunderbiscuit changed the title Discussion: consider removing libraries' links from spec Discussion: consider removing libraries' links from spec readme Feb 6, 2024
@thunderbiscuit thunderbiscuit added the documentation Improvements or additions to documentation label Feb 6, 2024
@thesimplekid
Copy link
Collaborator

Agree, think it makes sense to move them to https://github.com/cashubtc/awesome-cashu or similar and remove them from the spec repo.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants