I wish there was a way to upvote something 10x once a month here. This would be the post I use that on. When I was writing my book my editor asked me to remove any writing about mistakes and changes I made in the project for each chapter. I had a bug that appeared and I wanted to write about how I determined that and fixed it. They said the reader wants to see an expert talking, as if experts never make mistakes or n…
>They said the reader wants to see an expert talking, as if experts never make mistakes or need to shift from one tact to another. Your editor was very fucking wrong.
I also think this is the way the majority of tech books are written.
Can you think of another where the author goes from mistake to mistake and then finally gets it right?
I believe there is a space in tech writing for this kind of writing, but it is not something traditional book publishers believe.
This was an O'Reilly book by the way, with really good editors and a really good editoral process.
That editor was right most of the time, IMHO.