yet even more improvements to README API section