Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
-
@Defi4NT not happy being in reason with this, but ... I like to read and learn, not to fight against a bunch of unordered nonsense characters in a single block.
-
I'd forked and I'm reworking an outdated parsing library in Python which uses different modules avaliable for the task just for learning purposes, and I'm learning a lot more by try-fail than the doc itself. As you say, examples are not in context. I'm reworking the poor doc the project has as well, and I believe it, it's hard to do both things at the same time. But it really pays in long term. The future yourself will be kissing his own ass for that! 😂
I'll make the documentation after just some lines of code
When you died but forgot the documentation
BeautifulSoup (python module) doc is a single block of text which has an everlasting scrolling and hard to read. Examples are ok, but come on, we're devs, not text parsers. We need clear, clean and visual documentation. I neither like the organization of the Facebook API docs. It was a nightmare to build my first simple app. There are tons of this kind of messy, almost unreadable and confusing docs. It's strange, but usually these kind of docs are related to open source projects. Long life to markdown and github.
undefined
wk16