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

Update README.md #7

Merged
merged 2 commits into from
Jun 26, 2024
Merged

Update README.md #7

merged 2 commits into from
Jun 26, 2024

Conversation

fpseverino
Copy link
Member

Add shields.io badges to the README

@fpseverino fpseverino requested review from gwynne, 0xTim and ptoffy June 26, 2024 08:03
Copy link
Member

@ptoffy ptoffy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So besides the badge I must say I'm not a fan of the naming in this package. Looking at the README, an example is the PassKitPass model: IMO elements in a package shouldn't contain the package's name in their name. For example, PassKitPass, if explicated, would be PassKit.PassKitPass which is just ugly. I think it should be just named Pass, the same goes for PassKitPassData (should be PassData) and PassKitRegistration (should just be PassRegistration). Passes isn't PassKitPasses so I don't see why the rest should be. There might be more similarities which don't show up at a glance. I'm not going to block the PR as it's not an issue with the PR itself but yeah

README.md Outdated
<img src="https://img.shields.io/codecov/c/github/vapor-community/PassKit?style=plastic&logo=codecov&label=codecov">
</a>
<a href="https://swiftpackageindex.com/vapor-community/PassKit">
<img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fvapor-community%2FPassKit%2Fbadge%3Ftype%3Dswift-versions" alt="versions" />
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We might want to use the same Swift version badge as the other Vapor packages? Just to have everything inline

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok. Do we have a Vapor "platform" badge or should I keep the SPI one? Or remove it completely?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or maybe I could add a <br> before the two SPI badges so that they don't stick out next to the others

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I took heavy inspiration from it 😂 and there isn't a platform badge similar to the one from SPI.
So what do you suggest, to remove the SPI platform badge and substitute the version one, or to put both on a new line?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh the platform one sorry, I mean feel free to keep it if you want but it should be pretty self-explanatory that it's for the server as it is a Vapor package after all 😅

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And when I said inline I meant to have it the same as the other Vapor packages, not literally on the same line

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it, you're right

@fpseverino
Copy link
Member Author

So besides the badge I must say I'm not a fan of the naming in this package.

Yeah, it's a problem. I've started renaming something with the previous PR, but I'll finish the work when I add the Orders module and define which elements should be shared

@fpseverino fpseverino requested a review from ptoffy June 26, 2024 08:46
@fpseverino fpseverino merged commit 72495e1 into main Jun 26, 2024
8 checks passed
@fpseverino fpseverino deleted the update-readme branch June 26, 2024 08:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

2 participants