I started this 2-part series by Don't Read Books. What should we do instead?
There is no silver bullet, but I have few proposals that anyone sharing knowledge in text form can do to rise quality of the content better and make readers get more out of it in the long-term.
It will not earn as much money as "bestselling" books, but if you value education more than money like me, keep on reading.
Is there a code in your post or chapter, piece of text? It should be tested. Back to our Symfony book. Imagine you buy it, you read it and there is section about forms. But thanks to everlasting deprecation effect, you happen to use Symfony 4.1, but book is about Symfony 3.0, so it doesn't work and you've just wasted 20 $ in money for a book and hundreds $ in time investment.
Now imagine this post would be tested, with unit tests and Travis CI that would run daily to make sure the content is still valuable in the present. The day new Symfony with BC break is released, the new version of post is published. And that works super easily for version 4, version 5, version 6...
Btw, I know you can find up-to-date know-how for Symfony Forms in the documentation, but this is just an example. It could be any more complex non-documented code, like writing a Console application with Dependency Injection.
...or at least your thoughts. A book content is one-man-show, with one-man ideas and I think that is dangerous, unless we talk about God that helps us all and everyone can agree on that. I don't think my ideas are the best and that I know everything (or anything). I just want to open discussion in the best direction I believe at the moment.
"The community of people knows much more
than the most skilled person in it."
If people cooperate and talk to each other, they can bring much more value and higher quality solutions. That's probably the reason companies have more than 1 employee, right? :)
How to allow this in written content? Simple - allow comments. Allow them all the time, without censorship of opposed ideas.
That way people can express themselves and improve content to be:
If you allow comments, it's the first step to improve the content. But most people read the content and not the comments - by naturally, you need to read the post, so you could understand comments under it.
What if the readers could change the content? And what if you make it as easy for them as clinking a link.
That way the content is cooperative work of more people, more authors would be happy to share it and get credit for it. 3 posts about Symfony Console proven practice by 3 different authors can never be as good as 1 written by 3 authors together.
Each of us has different experience, past, motivation and know-how. It makes no sense that all of us read whole book about Symfony.
Also each skill has a group - a cluster of knowledge of various levels that you can master.
It makes no sense that everyone would read the same book from beginning till the end. Instead you can start at level 5, I can start at level 2, and somebody only wants the level 10, if there is something new he can learn in the field he thinks he masters already.
With a cluster of posts, you can see clearly where to start and what you want to read.
This is connected to prerequisite skill system. Each skill is followed by the nearest one that is super easy to learn thanks to previous experience. Compare 2 learning scenarios:
Which can build on previous experience and utilize neuron patterns faster?
The last but most least, people often return to content they believe in and look for iterative improvement in it. That's why we use StackOverflow and see answers that worked in 2015 to have 100 vote, but also there is a new one in 2018, that has already 20 votes and in 2020 there will come even better one...
That's why I try to make clear what and how changed right in the beginning on such posts.
And also not to promote outdated deprecated know-how:
You might see this as redundant work and that I'm a nerd (guilty!), but I'm super-focused on you, my readers and I want you to understand every change that happens so you can learn fast in safe environment.
First, I started this series as to show you the idea of clusters on my site, but then it went much further beyond that.
Check the idea and feedback me, what do you think about that.