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…
“This is the worst documentation I have ever seen in my life”
91–100 of 112 posts
Re: “This is the worst documentation I have ever seen in my life”
#92I 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…
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 p…
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.
Re: “This is the worst documentation I have ever seen in my life”
#93I won't touch any of amazon's products with a 10ft pole because of the way they treat their warehouse workers. Making their warehouse employees pee in bottles to make their metrics or risk being fired, that's just on a whole new level of extracting every joule of work out of a human being.
fair but wildly off-topic.
That strikes me as wildly hyperbolic.
Re: “This is the worst documentation I have ever seen in my life”
#94Re: “This is the worst documentation I have ever seen in my life”
#95I 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…
that website breaks my browser back button
Re: “This is the worst documentation I have ever seen in my life”
#96In which case either Amazon is or isn't important to them. If it is, they can just tell the person to get over it and do their job. If it isn't then they aren't an important customer for Amazon either.
In neither case is there any incentive for Amazon to improve.
Such is life with a lot of enterprise software in my experience.
Re: “This is the worst documentation I have ever seen in my life”
#97Earlier quoted context omitted.
I thought I was the only one! When I look around at the code examples using openCV it is clear that nobody knows how to use it. God help you trying to get your GPU working on Python.
Matplotlib...
OpenCV can’t be assed to link out to source, and also won’t even bother telling you what the function signatures are, what the names of all the methods are, or anything else useful.
Re: “This is the worst documentation I have ever seen in my life”
#98I won't touch any of amazon's products with a 10ft pole because of the way they treat their warehouse workers. Making their warehouse employees pee in bottles to make their metrics or risk being fired, that's just on a whole new level of extracting every joule of work out of a human being.
Re: “This is the worst documentation I have ever seen in my life”
#99"@amzn amzn locked as too heated and limited conversation to collaborators 3 hours ago
@seanevan seanevan closed this 3 hours ago"
Re: “This is the worst documentation I have ever seen in my life”
#100~13 years ago (!) I worked with the Amazon Seller API and left this comment in my own source code: // the XML returned from this request is *mind-bogglingly* bad. Terrifyingly bad. // a completed batch looks like this: // batchid=363777811 status=Done dateandtime=09/18/2007 09:53:10 PDT activateditems=335 numberofwarnings=0 itemsnotacivated=17 // and an incomplete batch like: // batchid=363778361 status=In Progress /…
That looks like putting " " and " " around a legacy text format and call it a day, to report that your service/API "supports XML" lol. Actually, SGML has mechanisms (shortrefs and "data tags") to parse strings like that as markup and could even infer " " tags (but it still won't work satisfactorily with your example data).