Re:Writing a technical book: from idea to print
by jacques_chester on Wednesday November 18, 2020 @02:16PM
(#25141084)
> So many times I found myself trying to explain something and realizing that either I didn't actually know how it worked and ended up spending hours (days?) researching the inner workings of said thing
This has been, by far, the best thing about writing.
It is also, by far, the worst thing about writing. The constant terror that I am full of shit.
Re:Writing a technical book: from idea to print
by __mharrison__ on Wednesday November 18, 2020 @04:46PM
(#25142849)
This is a good tip. If you are writing a project/code heavy book, write the code first. They re-write the code taking intensive notes along the way. There's your outline.
> For my first few sections I wrote the code as I wrote the sections, but then Lak made the suggestion that it would probably be easier to write the code first and then write the chapter
I can echo this a thousand times, I've written the last three chapters this way and this has made a huge difference, wish I had known that earlier!
I will also add that it really made me learn so much because even though I thought I knew quite a bit about Ruby (I knew early on that I didn't know much about Redis). So many times I found myself trying to explain something and realizing that I didn't actually know how it worked and ended up spending hours (days?) researching the inner workings of said thing
PS: Using quotes around book mostly because that's the imposter syndrome kicking in, I was calling it "a series of blog post" for a while, to kinda downplay it