I would preffer more or less the api style docs with short general examples. than a lot of unusable text.