Monday, June 15, 2015

non fiction - Writing first programming book


I was recently asked if I was interested in writing a book for a pretty reputable publisher, which of course I accepted. I am not a writer by trade, I am a software developer with some technical writing training. The longest thing I have ever written is a dissertation on distributed computing, which is hardly the same as a book. Of course, this book is about a programming topic and needs to be instructional and informative. My problem is how to get started; I have been sitting at my computer now for about 3 hours and have re-written my introduction about 25 times now.



I am using Scrivener as my writing tool, which I have used for other reference-type works but for some reason I just have nothing in my brain to get started, my cork board is totally devoid of notes! I don't know what to do and I am feeling totally intimidated! Does anyone have advice for a first time book author to get started? I would be interested to know what your process is for getting started and how you organize thoughts!



Answer



Close the intro. Promise yourself that you will write it last.


Start a blank Scrivener page.


Start writing down everything that comes into your head about the topic. Follow your thoughts wherever they lead, but make each thought a new line. Don't organize; just write.


When you run out of steam, go back to the top of the list, look at each thought, and see if it generates more stuff.


Keep doing that until you can't think of more stuff to add to the list.


Now that you have a list of stuff, start grouping it. Since I know squat-all about programming, I'll use gardening for my example.



  • Group A: planting


  • Group B: weeding

  • Group C: harvest

  • Group D: insecticides

  • Group E: types of plants

  • Group F: organic

  • Group G: color

  • Group H: season


and so on. Just put the letter (A) in front of any statement to do with planting.


Make new pages for each of the Groups. Copy everything with an A to the A:Planting page. Copy everything with a B to the B:Weeding page.



The lovely thing about Scrivener is that you don't have to put stuff in order yet. So once you have all your F:Organic statements together, just start writing. Do an info dump of everything you know about Organic Gardnening. When you run out of stuff, go to whatever topic strikes your fancy next.


After a while, you will have enough information to see how your book should be structured, or you can find an editor who can help you organize everything. You can drag your pages around any way you like.


The important thing is to get it all typed out. You can rearrange once you've gotten it on the page.


No comments:

Post a Comment

technique - How credible is wikipedia?

I understand that this question relates more to wikipedia than it does writing but... If I was going to use wikipedia for a source for a res...