Hacker News new | ask | show | jobs
by sonny3690 2017 days ago
I know it doesn't solve all the aspects of how broken this documentation is: but here's a pull request that somewhat tries to address it.

The Pull Request:

https://github.com/amzn/selling-partner-api-docs/pull/209

The Deployed Docs:

https://docs.contour.so/amzn/selling-partner-api-docs

Lots of bugs still to fix but hopefully it's helpful to anyone. Super open to any feedback!

---- Edit: To make it clear, the docs are built on a web app I built while on break from school. Sorry if that wasn't clear before!

3 comments

All you've done is deploy the existing documentation on your own service and change the links on the GitHub repository to point to your service rather than the GitHub documentation (with no indication of how one would keep this in sync with updates).

Sure, it makes navigating this version of the docs slightly easier, but this doesn't seem to be a good-faith attempt at actually improving the documentation so much as promoting your service.

Holding my two hands up--I saw this post on HN and wanted to help, and using a web app that I've built seemed to be the logical step.

But yeah, I could definitely see how it would come across this way, and I'll revert the links back to the PR! Hope that helps.

You should be transparent about the fact that contour.so is your product.

Also, I do not think contour.so addresses any of the real concerns about the documentation.

that website breaks my browser back button
that's one way to improve your bounce rate