zafarkhaja / jsemver

Java implementation of the SemVer Specification
MIT License
429 stars 82 forks source link

add link to mvnrepository.com for version listing #67

Closed alexanderankin closed 6 months ago

alexanderankin commented 6 months ago

66 was closed, not sure if intentional or due to renaming of the branch

zafarkhaja commented 6 months ago

My bad, wasn't intentional :)

As to your code change, I appreciate the effort but I don't think it's that essential to be added to the README. Sorry.

On the one hand, I'm striving to keep the README as succinct as possible by leaving only what's essential in order to reduce the cognitive load on users. I'm sure that as more features are added in the future I'll be forced to add more text, so I have to choose wisely what to include now.

On the other hand, I haven't seen other repositories do this. Maybe because it's public information, and everyone can easily find it using a search, if they need it. Or, maybe, it's because the current and future versions are more interesting to the users. Personally, I don't believe anyone would search for version 0.7.1 of the library. You don't wanna use that :))

alexanderankin commented 6 months ago

Sure - just first thought i had when i saw this was "oh, no, its not even 1.0 yet", followed immediately by "oh wait, im reading a readme, not a database, lets double check".

but then i saw on mvnrepository there are 274 consumers of version 0.9.0, which is something I'd want my users to know if i had a library with that kind of adoption. looking forward to the future, i asssume there will be breaking changes with 1.0, so users may visit and want to find out what version they can try instead of latest.

consider also jackson, which links to search.maven.org: https://github.com/FasterXML/jackson-databind as one of their "status" badges ("artifact"), I do not see it on spring boots page (which links to start.spring.io which lists several framework versions, but its not the same thing). https://github.com/square/okhttp also links to search.maven.org ("The latest release is available on Maven Central.")

np though, totally your project, up to you

zafarkhaja commented 6 months ago

Sure, totally get your point, but you can always compare number of stars to help you make a decision. Also, there's a "Used by" section on the right-hand side of the repository's main page, which leads to the Dependency graph where you can see how many and who the dependents are.

For example, this library's dependents: https://github.com/zafarkhaja/jsemver/network/dependents