I have been tasked to start writing white papers on security subjects. I was curious, those of you who are white paper writers, what tips or suggestions you might have for me to become a good white paper writer. I greatly appreciate any input. Thanks
Know your subject. Read other papers, articles, etc. so that you know what other people are doing and so that you know the benefits and drawbacks of their approaches as well as your own.
Have someone who is not an expert, but who should be able to understand your papers, read them and give you feedback as to whether the papers are understandable. If your reader doesn't understand one of your papers, take him seriously. Your explanation probably left something out.
Test and re-test any code, commands, or configurations that you include in your paper. You don't want to publish a paper with code that doesn't compile or commands that don't work.
Include links or references for background/further reading at the end. Some people may want to read more background in order to understand your paper or to move on to related or more advanced topics. Even a couple of links or references can be helpful. Choose other papers or books that you've read and think are appropriate. Dont' just slap in some random references you aren't actually familiar with.
Buy a copy of The Elements of Style by Strunk & White. It's a standard guide to grammar and style that many writers use (for good reason). It's also very short and easy to read in short spurts. Theirs is sage advice; follow it.
Don't use passive voice (most of the time). This rule isn't absolute. Sometimes you'll use passive voice in a sentence because it sounds right, but if you use it too much your writing will sound weak.
Registered users: No registered users In total there are 66 users online :: 0 registered, 4 hidden and 62 guests (based on users active over the past 5 minutes) Most users ever online was 1535 on Fri Feb 01, 2008 3:38 pm Legend: Administrators, Global moderators