Fully agree -- documentation as markdown committed alongside the code (and processes to ensure that it is kept up-to-date, discoverable and browsable) is the best way to avoid docs going stale or abandonned.
That's the challenge we at Komment (komment.ai) are taking on -- providing tools to maintain high-quality, up-to-date code documentation. We enable developers to spend more time developing, and less time documenting or figuring out what undocumented code does :-)
A magnetic object attracts or repells another object with the exact same strength that affects it. Look up Newton's third law, in case your not familiar with it -- can't tell from your messages.
I'm a bit confused about the point you are trying to make.
Based on your comment history, you seem comfortable with taking liberties with the English language to get your point across quickly (e.g. omitting implicit pronouns and articles in sentences such as 'Somehow never was true with Iceland.', or 'They should quit Euro (Merkel will never allow because others would follow suit) and debase currency. Do exactly as Iceland did.')
So I'm not sure why you seem to take particular issue with 'econ', which is a very common casual way to refer, e.g., to the economics major at uni. ('econ 101' etc)
I used to have it (French accent) on Google voice search, until mid-2013. Nowadays the same service works really well for me, so they definitely improved something.
I find that scientific textbooks (machine learning, etc) are much more usable as books than as pdf, as I need to often jump from one chapter to another and it needs to be the matter of a split second (or I won't bother to look for the information).
I haven't said anything about clearly and succinctly though; I do not know if that kind of material exist. I believe the book to be a mix of original material, existing research (as linked above), and most of all the fruit of many years of productive research on these topics.
You are of course free to not buy Piketty's thesis based on his book alone; however, to convincingly build your case to convince others, it looks like you may have to absorb a fairly considerable body of knowledge.
On a more personal note -- while I am an economist by training (doctorate obtained in early 2010s in a top 10 uni), my field was quite far from Piketty's, so I am not in a position to know with any confidence whether he's right or wrong. (I would say though that his position certainly has merit and deserves the attention it is getting.) That being said, I maintain that Taleb shows himself as disconcertingly naive and frankly quite condescending to think that he can dismiss years of research in a few witty disparaging paragraphs. (Possibly without reading the book, almost certainly without reading the research, and very definitely without looking at the raw data.)
This is a book for a wide audience. Not the right place for maths. But Piketty is a very respected researcher (at home and internationally), with an excellent grasp of the state of the art in econometric and economic modelling ('math'). Read his papers if you mistrust text and graphs.
Yes the maths are likely right, but that does mean Taleb is being fair to Piketty.
Economics is not just about the maths, it's about whether the maths being proposed (i.e. the model) are the right tool to understand and explain the observed data (and do predictions / counterfactuals). So the question of interest (is Piketty right or wrong) is not a question of someone's "maths" (either Piketty's or Taleb) being "right" or "wrong". Sorry if you find this obvious -- perhaps I missed the point of your question?
Taleb seems to be engaged in two vendettas (as is clear from reading the Black Swan): first, economists; second, the French.
One would therefore be well advised to take his notes about the work of a French economist with a pinch of salt.
"The optimal strategy is to go become an academic or a French-style civil servant, the anti-wealth generators."
To pick but one example among many others, Louis Pasteur was French, an academic and (therefore) a civil servant, and arguably contributed to save many lives. Or does that not qualify as wealth generation?
You seem to entertain a rather convenient set of beliefs and opinions. I pay a pretty hefty price because I do not share them (and go out of my way to 'do my part').