Profile

Tuesday, December 22, 2009

How To Write a User Manual: An Introduction to Technical Writing

I am honored and excited to be teaching an introductory course on Technical Writing at Temple University in Center City, Philadelphia:



How To Write a User Manual: An Introduction to Technical Writing
We have all been stumped when confronted by unclear procedures in a sloppily written user manual. Rectify this by learning to write clear instructions to produce a usable user manual for any product or process you care about. Avi Solomon, an experienced writer in the high tech industry, will lead you through a reliable, systematic method of technical writing to help you learn to design, write, edit and produce a practical user manual on a topic of your choice.

Session 1: What is Technical Writing?
Introducing Technical Writing, bad vs. good instructions, helping users kick ass!
Exhibit: Haynes Car Manual, Apollo Rocket Manual.

Session 2: How to Write a User Manual: A Systematic Method of Technical Writing
The nuts and bolts of a simple, effective method to write and produce effective user manuals for almost anything. The method consists of the following stages: Research, Task Analysis, Outline, Storyboard, Draft, Edit, Produce.
Exercise: Bring a Product or choose a Process you wish to write a User Manual for.

Session 3: Researching the User Manual
Enlist anthropological fieldwork to your aid, how to work with experts and users, recording data.
Exercise: Conducting Fieldwork.

Session 4: Task Analysis: Mapping the User:Task Matrix
How to organize and analyze the research data into a User:Task Matrix.
Exercise: Creating a User:Task Matrix Table.

Session 5: Outlining the User Manual
How to make an outline of your user manual.
Exercise: Outline your User Manual.

Session 6: Storyboard the User Manual
Storyboarding as a powerful writing tool, storyboard review and feedback.
Exercise: Storyboard your User Manual and conduct a Storyboard Review.

Session 7: Draft the Topics
How to write a procedure, integrating text and visuals.
Exercise: Draft your Topics

Session 8: Editing the User Manual
How to edit your user manual with fresh eyes.
Exercise: Edit your User Manual.

Session 9: Producing the User Manual
Using single sourcing to produce your manual in different output formats.
Exercise: Produce your User Manual.

Session 10: Student Presentations & Conclusion
Each student will present their user manual for critique, next steps in technical writing.

Please feel free to join or pass the course link to people who might
be interested:)

Wednesday, October 28, 2009

Avi's 'Storyboard Your Life' exercise

Many have found Storyboarding their lives a useful exercise to
understand past patterns, visualize positive life futures and make
them happen. Storyboards are not just for Moviemaking but for
Lifemaking!Storyboard Your Life
Join the 'Storyboard Your Life' Facebook group

Monday, October 5, 2009

How to Grow your own Food with Sub-Irrigating Planters

During these recessionary times it's a good idea to try and grow some of your own food to cultivate your sense of independence.

President Truman urges Americans to grow food

Many are daunted by this 'complicated' prospect and give up on the idea prematurely. But there is a simple, 'slam dunk' way to grow your own food: using Sub-Irrigating Planters or SIPs.


A DIY two bucket Sub-Irrigating Veggie Planter

You can make your own SIPs from open-source instructions using 5 gallon buckets and Earthtainers or buy commercial models like the EarthBox or Grow Box.

Sub-Irrigating Planters have a water compartment on the bottom with a "wick" of wet soil that lets the plants water themselves as needed using the power of capillary action. A water overflow hole indicates that the SIP is full and prevents you from drowning the plants:)

Self-Irrigating Planters can be easily setup even in high-rise apartments, eliminate weeds and pests, give high yields of organic "local" fruits and vegetables and save you money. All you have to do is to water them every few days and pick the harvest!

I setup four EarthBoxes early this spring on my South Street apartment's deck and reaped great results.

South Street Brandywine Tomatoes

We have not bought any tomatoes at the supermarket since May!
We have also enjoyed many intangible blessings like witnessing the miraculous visits of butterflies and bees to pollinate the tomatoes and the delectable satisfaction of watching and eating food we have grown. Bon appetit!

Wednesday, August 5, 2009

Birthing a Mother: The Surrogate Body and the Pregnant Self


My wife Dr. Elly Teman's superb ethnography of Surrogate Motherhood is now available on Amazon for preorder:)

Birthing a Mother is the first ethnography to probe the intimate experience of gestational surrogate motherhood.

In this beautifully written and insightful book, Dr. Elly Teman shows how surrogates and intended mothers carefully negotiate their cooperative endeavor.

Drawing on anthropological fieldwork among Jewish-Israeli women, interspersed with cross-cultural perspectives of surrogacy in the global context, Teman traces the processes by which surrogates relinquish any maternal claim to the baby even as intended mothers accomplish a complicated transition to motherhood.

Teman's groundbreaking analysis reveals that as surrogates psychologically and emotionally disengage from the fetus they carry, they develop a profound and lasting bond with the intended mother.

Teman shows how a potentially alienating experience for the surrogate becomes empowering and how the experience is transformed into a "hero's journey" through which they overcome very real personal obstacles with commitment and determination.

The result is a book that demolishes the myth of the "womb for rent" and powerfully affirms a joint project in which one woman assists another, through sacrifice and instruction, to become-also-a mother.


Birthing a Mother: The Surrogate Body and the Pregnant Self
by Dr. Elly Teman
University of California Press, 2010

Thursday, May 28, 2009

Natural Building with Cob

Thursday, April 16, 2009

Leo Strauss Speaks

Thursday, March 5, 2009

Leo Strauss: On the Interpretation of Genesis

Thursday, February 26, 2009

Esther: A Spy Story?

Some things in the Scroll of Esther make sense only on the assumption that Mordechai was running a spy ring in the royal palace that included the enuchs and that Esther was a newly minted spy on her first, crucial assignment:

- How exactly was Ahasuerus' order to Vashti worded by the enuchs who delivered the message to her?(1.10-12)

-Memucam suggests and the King accepts(1.21 )

-The servants suggest and the King accepts, Hegai is nominated(2.4)

-Mordechai has daily channels of communication with Esther(2.11)

-Esther follows Hegai's advice(2.15)

-Esther obeys Mordechai( 2.20)

-How did Mordechai know all about Haman's plot, including access to secret royal documents(4.7-8)

-Mordechai prods a reluctant Esther to act(4.13-14)

-Esther might have given an anti-sleep potion to Ahasuerus at the first wine feast( 6.1)

-How did the King's servants know to open the annals exactly on Mordechai's page?(6.2)

-Esther compromises Haman(7.8)

Purim Sameach!

Saturday, February 21, 2009

Avi @ boingboing



Here's a list of entries that I submitted that got published at boingboing. They should make me a honorary editor already:)

Ideo's Human Centered Design Toolkit, free download

Sympathetic ethnography of surrogate mothers

Sapolsky's outstanding Stanford lecture on "The Uniqueness of Humans"

Mickey Mouse comics drawn by concentration camp prisoner

Scans of Google Books with fingers in them

Hi-rez lunar astronaut portrait scans

Evolution, religion, schizophrenia and the schizotypal personality

Papercraft Wing Commander spaceships

Art from Basil Wolverton's Bible

Brain Rules: Oliver Sacks meets GETTING THINGS DONE, paperback ships, DVD goes free

Studio portraits of Mumbai's itinerant nomads

Stanford's Sapolsky on primate sexuality: funny, fascinating, educational

Sapolsky on primate sexuality part two: required viewing for the horny

Ted Chiang's story Exhalation -- free podcast

IDEO's deck of "Method Cards" for doing humane design

Stanford's Sapolsky and National Geo produce a documentary on stress

Black Swan author's rules for living

Heat maps of the world, colored by news-agencies' reporting on each country

Explaining food vs. nutrition: Michael Pollan talks at Google

Ex-IDEO lectures on creativity and management

Rare MLK speech on civil disobedience

Podcast of Ted Chiang's THE MERCHANT AND THE ALCHEMIST'S GATE

XO laptop -- a green miracle of energy efficiency: Video

Douglas Adams lecture: "Is there an artificial god?"

HOWTO build a yurt

Globalization of snacks: Vada Pav (TM) to kick McDonalds' ass in India

Indian epic Ramayana as comic

Corridor: a graphic novel of India

India's first professional DJ academy

Amul Indian Butter Ad Archive

Charles Darwin on Tsunamis (1835)

Yale Photonegatives Collection

Radio Free Mars

Psychology of bad probability estimation: why lottos and terrorists matter

Ghost dance video from "India's filmic Shakespeare"

Bollywood-star mudflaps

Indian infocomic: Yoga At Home

Help track down versions of King Solomon's Ring

Apollo 14 Astronaut Edgar Mitchell's Message Board

Slides from wonderful "engineering climate change" talk

Get your fresh, raw Mars image data right here, folks

Dogs that know when their owners are coming home experiment

Disney's 10 rules of theme-park design

Peter Ward dives to meet a wild Nautilus

Merlin Mann's productivity talk at IDEO

In memoriam: Parveen Babi, Bollywood Diva

The Nmap Revisited

6th man on moon says space aliens are real (and have visited us)

American Legion WWII posters

Tuesday, February 10, 2009

No Need to Die to Benefit from a Life Review

Saturday, January 31, 2009

Hot and Cold: Crucial Aspects of Herbalism

Letter to Uriel

Friday, January 30, 2009

'Regimen of Health' by Maimonides


". . . It is known to our sovereign, may God prolong his days, that the passions of the soul greatly alter the body in ways obvious to any observer. Consider a man with a powerful build, booming voice, and radiant face. If he were suddenly to receive news which greatly saddened him, in that instant you would see his complexion become pale, the radiance of his face fade, his bearing slacken, and his voice drop. Even if he were to struggle to raise his voice, he would not be able to. His strength would wane, he might tremble because of weakness, his pulse would diminish, his eyes would become hollow, his lids would become too heavy to move, his skin would turn cold, and his appetite would subside. The cause of all of these effects would be the natural heat and the blood withdrawing deeper into the body.

Conversely, consider an individual with a weak body, pale complexion, and feeble voice. If he were notified about something which greatly delighted him, you would see his body become strong, his voice rise, his face brighten, his movements quicken, his pulse increase, his skin warm up, and joy and delight become so apparent that he would not be able to conceal them. The cause of all of these effects would be the movement of the natural heat and the blood toward the surface of the body.

The characteristics of the fearful, anxious person and of the confident, relaxed person are known; similarly, the characteristics of the vanquished and of the victorious are obvious. Whoever is vanquished can hardly see anythings because his visual spirit is diminished and dissipated. However, the vision of the victorious person increases in such a massive way that the light of the atmosphere appears to have increased and grown. This is so obvious that it is not necessary to dwell on it.

For this reason physicians have recommended constant concern for, and awareness about, the soul's movements, as well as concern for putting them into equilibrium at the time of health and sickness-giving no other treatment precedence in any way. The physician should desire that every sick person and every healthy person be constantly cheerful and relieved of the passions of the soul causing depression. In this way the health of the healthy will endure. This is foremost in curing every sick person, especially those whose sickness pertains to the soul-like those with hypochondria and morbid melancholia. Indeed, concern about the soul's movements ought to be strongest for these people, as well as for anyone overwhelmed by worry, obsessive thoughts, apprehension about things not such as to produce apprehension, or anyone who is only slightly cheerful about cheerful things. For all of these people, the skillful physician should place nothing ahead of improving the condition of their souls by removing these passions.

However, insofar as he is a physician, the physician ought not to expect his art to provide knowledge of how to remove these passions. Indeed, this understanding is acquired from practical philosophy and from the admonitions and disciplines of the Law. For just as the philosophers have composed books about the various sciences, so too have they composed many books about improving moral habits and disciplining the soul to acquire the moral virtues so that only good actions stem from it.

They warn against the moral imperfections and teach every man who finds one of these moral habits in his soul the way to eradicate it so that the state of character leading to all evil actions disappears. Similarly, the disciplines of the Law, admonitions, maxims taken from the prophets (may peace be upon them) or from their followers, and knowledge of their virtuous lives improve the moral habits of the soul so that it obtains virtuous dispositions and only good actions stem from it.

Therefore you find these passions have a very great influence only on those individuals having no knowledge of philosophic ethics or the disciplines and admonitions of the Law-such as youths, women, and foolish men. For due to the excessive tenderness of their souls, these people become anxious and despair. If harm touches them and one of the calamities of this world befalls them, anxiety increases and that they cry out, weep, slap their cheeks, and beat their breasts. Sometimes the misfortunes become so great in their eyes that one of them dies, either immediately or after a while, due to the worry and grief which overwhelm him.

Similarly, if these individuals obtain one of the goods of this world, their joy thereby increases. Due to their souls being poorly disciplined, such individuals suppose that they have obtained a very great good, and their wonder and exultation greatly magnify what they have obtained. Because of that, they are greatly moved and their laughter and frivolity increase to the point that some of them die from excessive joy. This is due to exhaustion of the spirit from the intensity of its suddenly tending to be outside of itself, as Galen mentioned. The cause of all this is the soul's excessive tenderness and its ignorance of the truth of things.

Now it is persons trained in philosophic ethics or in the disciplines and admonitions of the Law whose souls acquire courage. These are the truly courageous; their souls are only swayed and affected in the slightest possible way. The more training an individual has, the less he is affected by either of the two conditions-I mean, the condition of prosperity or of adversity. Even if he obtains one of the greater goods of this world, which are the ones the philosophers call presumed goods, he is not moved by that; nor do those goods become great in his eyes. Similarly, if one of the greater evils of this world befalls him, which are the ones the philosophers call presumed evils, he does not become anxious nor despair, but endures it nobly.

A man acquires this disposition in his soul by considering the truth of things and by knowing the nature of existence. Even if a man possessed the greatest good of this world during his whole life, it would be very insignificant, because it is a perishable thing and because man, like all the other kinds of animals, must die. Similarly, if the greatest evil of this world is contrasted with death, which is inevitable, that evil is undoubtedly inferior to death. Therefore one should be less affected by that evil, since it is inferior to what is inevitable.

It is fitting that the philosophers called the goods and evils of this world, presumed goods and presumed evils. Indeed, how many of those goods are presumed to be good while being in truth evil, and how many of those evils are presumed to be evil while being in truth good? Again, how vast an amount of money and how many vain possessions has a man acquired which caused the corruption of his body, the degeneration of his soul through moral imperfections, the shortening of his life, his drawing away from God (may He be exalted), and separation between him and his Creator? Does that not give him everlasting misery? Moreover, how much money has been stolen from a man or how many possessions wrested away which caused the improvement of his body, the ennobling of his soul with moral virtues, the lengthening of his life, and his coming closer to his Creator by devoting himself to His worship? Does that not give him everlasting happiness?

Now the servant could speak about the length or shortness of life only by relying upon the opinion of the physicians, the philosophers, and some of the adherents of the religious laws prior to Islam. In sum, most of what the multitude presumes to be happiness is in truth misery, while most of what it presumes to be misery is in truth happiness.

It is not the purpose of this treatise to explain the truth of these matters, to comment on them, and to teach the ways to them. Much has already been composed concerning this in every age and by every wise nation which has studied the sciences. The servant only offered this advice as an indication of how to accustom the soul to diminish the passions by studying books on ethics, the disciplines of the Law, the admonitions, and the maxims spoken by intelligent men. In that way the soul will be strengthened and will see the true as true and the false as false. Thus the passions will diminish, [obsessive] thoughts will disappear, apprehension will be removed, and the soul will be cheerful in whatever condition a man happens to be.

Here is a very good thing to reflect upon. By it, bad thoughts, worries, and griefs are diminished. Sometimes they can even be completely destroyed, if a man holds this reflection foremost in his mind: Namely, whenever a man thinks about something that distresses him, and worry, grief, or sadness crop up in him, it can be due only to one of two things: either he is thinking about a matter that has already taken place, like someone who thinks about something that happened to him, such as the loss of his money, or about the death of someone dear to him; or else he is thinking about matters he expects and whose advent he dreads, like someone who thinks and talks about the advent of any disaster he expects. Now intellectual reflection teaches that thinking about what has taken place and has happened is of no benefit at all, and that sadness and grief about matters that have passed and gone are due to faulty understanding. There is no difference between a man's being grieved because of the loss of his money or similar things and his being grieved because he is a man and not an angel or a planet, or similar thinking about impossible things.

On the basis of this reflection, acts of thinking leading to depression about something that is expected to come to pass in the future ought also to be abandoned. That is because everything that a man expects is within the realm of possibility: it may take place or it may not take place. Hence, just as he becomes distressed and grieves lest what he expects occur, so too he ought to delight his soul with anticipation and hope that perhaps the opposite of what he expects will take place. After all, the expected matter and its opposite are both possible."

-Maimonides, On the Management of Health, Chapter 3

Sunday, January 18, 2009

Storyboard Your Life

Saturday, January 3, 2009

Abraham Abulafia: A Starter Kit


Abraham Abulafia: A Starter Kit

Wednesday, December 31, 2008

This Too Shall Pass / Gam Zeh Yaavor : Tracing an Ancient Jewish Folktale