Re:Technical blogging in the era of Stack Overflow
by shantnutiwari on Tuesday August 03, 2021 @06:42AM
(#28047640)
>>I'm also confused... who reads blogs but doesn't read the docs?
Most docs are hard to read- dense text, millions of options, and not a single example of a use case. Same with most man pages.
90% of the time, I just want to do something simple, and its easier to read thru blogs than trudge thru a dense hard to read official document.
And with Python-- you are guranteed to get out of date docs in Google search. Not just for Python 2, but older unsupported versions of libraries
Sometimes, the page even helpfully tells you it is out of date, and invites you to go to the home page and start searching again (rather than, you know, just link to the latest page)
Most docs are hard to read- dense text, millions of options, and not a single example of a use case. Same with most man pages.
90% of the time, I just want to do something simple, and its easier to read thru blogs than trudge thru a dense hard to read official document.
And with Python-- you are guranteed to get out of date docs in Google search. Not just for Python 2, but older unsupported versions of libraries
Sometimes, the page even helpfully tells you it is out of date, and invites you to go to the home page and start searching again (rather than, you know, just link to the latest page)