Shawn Wang
100 Bytes of CSS to look great everywhere
An Article by Shawn Wanghtml { max-width: 60ch; padding: 1.5rem; margin: auto; line-height: 1.5rem; font-size: 24x; }
Metrics have a strange hold on the imagination
A Fragment by Shawn WangOnce in place, metrics have a strange hold on the imagination: I've seriously had a CTO carelessly reject my genuine idea out of hand because "it doesn't help OKRs", the same OKRs we previously agreed should not describe all that we do.
I agree with Amir Shevat that we should "do the right things over the easy to measure things."
The Genius of Apple's Name
An Article by Shawn WangIt's easy to have strong opinions about stuff only developers see since user validation is just asking people like yourself. It's much harder to name something consumer facing. Here are some useful rules I gleaned from Apple:
- Two syllables max
- Familiar English word - literal 5 year olds can spell and pronounce it right
- Starts with A - useful for alphabetical sort. Amazon did this too
- Name leads to easy logo/swag/branding ideas
- Evoke aspirational qualities - knowledge, health, nature
Don't Rush to Simplicity
An Article by Shawn WangYou've probably heard this story before:
A businessman finds a fisherman, who is living an idyllic, peaceful life by the sea.
He laughs and tells the fisherman how to get rich instead.
The fisherman asks him what he will do after he gets rich.
He replies that he would retire to an idyllic, peaceful life by the sea.There's supposed to be a deep life lesson in there, but it's always felt insincere to me.
To me it is better to have reached the heights of a career, or suffered an epic defeat, even if I do end up in the same place as everyone else in the end.
To me simplicity is made more beautiful when understood through a long personal struggle with complexity. When I can dance with it, having turned a mighty nemesis into an old friend, and teach others to do the same.
Better to have loved and lost, than never to have loved at all.
80/20 is the new Half-Ass
An Article by Shawn WangThe Pareto Principle is making you lazy.
Let me be more precise: The Pareto distribution is a useful model of power law effects in real life. But people are using it poorly, primarily as an excuse to be lazy.
...People forget that the devil is in the details. The first 20% everyone knows to say on Twitter. The remaining 80% is the ugly, nasty, hacky, unglamorous shit nobody talks about unless you've got time to sweat the details.
The Elements of Style
- Choose a suitable design and hold to it
- Make the paragraph the unit of composition
- Use the active voice
- Put statements in positive form
- Specific, definite, concrete
Choose a suitable design and hold to it
A basic structural design underlies every kind of writing.
Writing, to be effective, must follow closely the thoughts of the writer, but not necessarily the order in which those thoughts occur. This calls for a scheme of procedure. In some cases, the best design is no design, as with a love letter, which is simply an outpouring, or with a casual essay, which is a ramble. But in most cases, planning must be a deliberate prelude to writing.
The more clearly the writer perceives the shape, the better are the chances of success.
Make the paragraph the unit of composition
As a rule, begin each paragraph either with a sentence that suggests the topic or with a sentence that helps the transition.
More commonly, the opening sentence simply indicates by its subject the direction the paragraph is to take.
Use the active voice
"I shall always remember my first visit to Boston” is better than "My first visit to Boston will always be remembered by me."
Put statements in positive form
Make definite assertions. Use the word not as a means of denial or in antithesis, never as a means of evasion.
"He was not very often on time” becomes “He usually came late.”
“She did not think that studying Latin was much use” becomes “She thought the study of Latin useless."
Consciously or unconsciously, the reader is dissatisfied with being told only what is not; the reader wishes to be told what is.
If your every sentence admits a doubt, your writing will lack authority.
Specific, definite, concrete
Prefer the specific to the general, the definite to the vague, the concrete to the abstract.
Omit needless words
When a sentence is made stronger, it usually becomes shorter.
Vigorous writing is concise. A sentence should contain no unnecessary words, a paragraph no unnecessary sentences, for the same reason that a drawing should have no unnecessary lines and a machine no unnecessary parts. This requires not that the writer make all sentence short, or avoid all detail and treat subjects only in outline, but that every word tell.
The principle of parallel construction
This principle, that of parallel construction, requires that expressions similar in content and function be outwardly similar.
Blessed are the poor in spirit; for theirs in the kingdom of Heaven.
Blessed are they that mourn; for they shall be comforted.
Blessed are the meek; for they shall inherit the earth.Steering by stars that are disturbingly in motion
Here we leave solid ground. Who can confidently say what ignites a certain combination of words, causing them to explode in the mind? Who knows why certain notes in music are capable of stirring the listener deeply, though the same notes slightly rearranged are impotent? These are high mysteries, and this chapter is a mystery story, thinly disguised. There is no satisfactory explanation of style, no infallible guide to good writing, no assurance that a person who thinks clearly will be able to write clearly, no key that unlocks the door, no inflexible rule by which writers may shape their course. Writers will often find themselves steering by stars that are disturbingly in motion.
Design informs even the simplest structure
Design informs even the simplest structure, whether of brick and steel or of prose.
Even the kind of writing that is essentially adventurous and impetuous will on examination be found to have a secret plan: Columbus didn’t just sail, he sailed west, and the New World took shape from this simple and, we now think, sensible design.
Do not overstate
When you overstate, readers will be instantly on guard, and everything that has preceded your overstatement as well as everything that follows it will be suspect in their minds because they have lost confidence in your judgment or your poise.
A single overstatement, wherever or however it occurs, diminishes the whole.
Do not explain too much
It is seldom advisable to tell all.
Place the emphatic words of a sentence at the end
The proper place in the sentence for the word or a group of words that the writer desires to make most prominent is usually the end.
The principle that the proper place for what is to be made most prominent is the end applies equally to the words of a sentence, to the sentences of a paragraph, and to the paragraphs of a composition.
Writing is one way to go about thinking
And the practice and habit of writing not only drains the mind but supplies it, too.
Style is not separate from substance
Young writers often suppose that style is a garnish for the meat of prose, a sauce by which a dull dish is made palatable. Style has no such separate entity; it is nondetachable, unfilterable. The beginner should approach style warily, realizing that it is an expression of self, and should turn resolutely away from all devices that are popularly believed to indicate style - all mannerisms, tricks, adornments. The approach to style is by way of plainness, simplicity, orderliness, sincerity.
The young writer should learn to spot them - words that at first glance seem freighted with delicious meaning but that soon burst in air, leaving nothing but a memory of bright sound.