3 ms·
I would love to see something like this for `pandas`. Also SQLAlchemy. EDIT: apparently there's a very limited set of oneliners for `pandas` already. Why do so
by ledauphin 5y ago
I would love to see something like this for `pandas`. Also SQLAlchemy. EDIT: apparently there's a very limited set of oneliners for `pandas` already.
Why do so few libraries seem to understand that good documentation starts by providing meaningful examples of simple tasks with semantic labels that can be found via search? Reference-style documentation assumes that you already know the name of the thing you're looking for (you don't), or that you have time to read for several days and build up an entire mental model of the system in one go before getting anything productive done (also no).
- muggermuch 5y ago+1 absolutely - it's been one of my pet peeves. There really needs to be some thought put into "doc UX".
- na85 5y agoThe worst is when some project or library is extolled as being extensively documented and you find out it's just doxygen autogens. Awful.