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

Consider moving "how to use" section of README #571

Open
wzieba opened this issue Feb 10, 2025 · 2 comments
Open

Consider moving "how to use" section of README #571

wzieba opened this issue Feb 10, 2025 · 2 comments
Labels
documentation Improvements or additions to documentation

Comments

@wzieba
Copy link
Member

wzieba commented Feb 10, 2025

hi 👋! I've noticed that it's not easy to see how to start using the Gravatar Android SDK:

  • the code snippet explaining how to add the SDK is on the bottom of the README
  • it's also titled "publishing" which I initially missed (I was interested in using the SDK, not publishing it)
  • and, this is minor but still, it's written in Groovy, while I think it'd be a nice thing to add Kotlin Script syntax as well

This is opinionated but, I'd also suggest moving most of the README to the GitHub documentation as I think it has many details regarding implementation, rather than using it, which seems to not be very useful for casual users. I'd encourage getting inspiration from some other popular SDKs

I hope that you'll find this feedback useful, and thanks in advance for considering changes!

@wzieba wzieba added the documentation Improvements or additions to documentation label Feb 10, 2025
@AdamGrzybkowski
Copy link
Contributor

Hi @wzieba,

there's a section Getting Started a the top of the README.md that links to a separate .md file with the full instructions on how to use the SDK.

I don't think the Publishing section was meant to be doing that, so maybe it's worth removing the part about how to add it to the project.

@wzieba
Copy link
Member Author

wzieba commented Feb 17, 2025

Ah I see, it's indeed at the top. Thanks! Anyway, I'd still suggest moving most of this readme to some documentation section.

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