alt Hacker NewsSeriously, why can't huge companies like OpenAI and Google produce documentation that is half this good??
https://api-docs.deepseek.com/guides/thinking_mode
No BS, just a concise description of exactly what I need to write my own agent.
Replies
I am very partial to Mistral's API docs https://docs.mistral.ai/api
Because they produce revenue from products which abstract this away
It's because they're optimizing for a different problem.
Western Models are optimizing to be used as an interchangeable product. Chinese models are being optimizing to be built upon.
Meanwhile, they don't actually say which model you are running on Deepseek Chat website.
You might enjoy Z.ais api docs aswell
Western orgs have been captured by Silicon Valley style patrimonialism, and aren’t based on merit anymore.
I spent only two minutes reading their documentation and it’s clear no one did any proofreading and it’s full of mistakes made by non-native speakers.
Example: the second sentence on the first page says “softwares” but “software” is a mass noun that cannot be pluralized.
Example: the third page about tokens has some zipped code to “calculate the token usage for your intput/output” and obviously “intput” should be “input” but misspelled.
As a company that produces LLMs, they could have even used their own LLM to edit their documentation to fix grammar issues, and yet they did not.
Maybe I’m just extra sensitive to grammar and spelling issues but this kind of lack of attention to detail is a huge subconscious turnoff. I had to fight my urge to close the tab.