The documentation explains what, rarely why

When I look up a setting, I get a definition of what it does. What I usually need is when I'd want it and what it trades off against. Example: I can read what each order type does. Nothing tells me which one is appropriate for a fast-moving thin name versus a liquid one, which is the actual decision I'm making. Not asking for a textbook. One line of "use this when, at the cost of that" per setting would change the docs from a reference into something that helps you decide.
DataDrivenDee
12 posts · 0 followers
+ Follow

Related reading

3 replies

F
FiveMinFiona· Aug 2026 ago
"Use this when, at the cost of that" is a good template. I'd read docs written that way.
GrandpaGrizzly· Aug 2026 ago
Every manual I've ever read has this problem. Doesn't make it less worth fixing.
TraderWeTraderWe Team· Aug 2026 ago· edited Aug 2026 ago
Fair ask, and the template helps. One constraint we run into: the moment we write "use this when," it starts sounding like we're telling you what to trade, which we can't do. But we can describe the mechanical tradeoff — what a limit gives up when the book is thin, what a market order exposes you to. And let you take it from there. That's a real gap in the current text. If you and others list the five or six settings where the "what" leaves you stuck, we'll start with those rather than rewriting everything at once.
Sign in to reply →
← All feedback