"The dive right into the hands-on; give readers something to do
right away with minimal exposition. Wrap up with more detailed
explanations of theory and concepts, and references to additional
"Keep articles narrowly focused--don't try to cram too much into
a single piece. It's better to address a small task in detail than
to cover a lot of ground too shallowly. You can always turn a long,
complex topic into a series of nice bite-sized chunks.
"Your readers will adore you if you don't shy away from the hard
parts. If you find yourself wanting to write "see the man page for
details" instead of outlining the steps yourself, take another look
and see if you're trying to take the easy way out. The only place
"see foo for more information" belongs is at the end in an
additional references section."
Some of the products that appear on this site are from companies from which QuinStreet receives compensation. This compensation may impact how and where products appear on this site including, for example, the order in which they appear. QuinStreet does not include all companies or all types of products available in the marketplace.