Posted on August 5th, 2011
A cookbook contains a set of “recipes” for completing particular tasks related to a particular technology. Each recipe:
- Describes the task
- Outlines a carefully organized sequence of instructions to complete the task as efficiently as possible
- Lists any related tasks
In addition, the recipe may also provide further information about task in other situations, or different options for completing the task.
Cookbooks offer a quick way to get things done, and are designed Cookbooks offer a quick way to get things done, and are designed for people to “dip into”. Do not expect readers to read the cookbook from start to finish.
The scope should take the reader from some basic, every-one-should-know activities to more advanced (requiring knowledge of several elements of the topic) activities. Ideally, the book will present some “beyond the ordinary”/”I didn’t know you could do that” activities.
There will be no other sections or text between recipes – the recipes are everything!
Recipes must fit this format:
- Getting ready… (optional)
- How to do it… Only the steps to get something done
- How it works… Explain the steps
- There’s more… (optional) Chance to go into greater depth
- See also… (optional) Related recipes
Leave a Reply
You must be logged in to post a comment.