question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Confusing Documentation on Github Readme

See original GitHub issue

The documentation available on the readme is very confusing.

For example, after setting up proper authentication, the first example presented is: shop = shopify.Shop.current()

In the rest of the example the variable shop is never used and there’s no explanation of what this line does or why it’s necessary (is it necessary?)

Additionally it’s stated that everything is returned as an ActiveResource, with no explanation of what that is, what it offers, or how it affects how the api should be used.

For many, this README is the first and only point of information for usage of this library, and some more clarity in the documentation would go a long way. Please consider revamping the README so us shopify newbies can get up to speed faster 😄

Right now I’m balancing whether I’d rather read the code to figure this out or open source an easier to use api.

Issue Analytics

  • State:open
  • Created 7 years ago
  • Reactions:3
  • Comments:8 (3 by maintainers)

github_iconTop GitHub Comments

6reactions
mkeegancommented, Aug 2, 2016

Fortunately Dropbox Paper can convert into markdown! File attached.

Shopify-Python-API-Cheatsheet.md.zip

1reaction
kevinhughes27commented, Aug 2, 2016

Looks pretty good! I would be happy to merge something like this to a markdown file in the repo

Read more comments on GitHub >

github_iconTop Results From Across the Web

How to Create Awesome README File For Your GitHub ...
If your README file doesn't look good, no one will be interested on your repo. So, how do you create nice READMEs? One...
Read more >
How can I sync documentation with Github Pages?
Remove the rendered HTML from the markdown in your README.md file. This is usually between <section> or <article> tags. Replace this HTML with...
Read more >
Learn Documenting / Reference - GitHub
Markdown Files; Repository Wiki; GitHub Pages for Organization; GitHub Pages ... the content is always visible on the master , which will avoid...
Read more >
Essential Sections for Better Documentation of a README ...
In 2007, the first GitHub repository's README was not ...
Read more >
What information should be in the github README.md?
I expect to see an introduction and brief overview. There should be something there to convince me that the project solves a particular ......
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found