eyal matsliah's Bookmarks tagged writing → View Popular
You are here: Diigo Home > eyal matsliah's Bookmarks
How to Write for the Web (Full Paper)
long detailed paper full of tips and suggestions for writing for the web
Tags: usability, web-design, web-writing, writing on 2008-02-26 and saved by6 people -All Annotations (1) -About
more fromwww.useit.com
Writing for the Web
a list of resources about
Research on how users read on the Web and how authors should write their Web pages.
Tags: list, reference, research, usability, web-design, web-writing, writing on 2007-12-25 and saved by48 people -All Annotations (1) -About
more fromwww.useit.com
Writing Inverted Pyramids in Cyberspace (Alertbox)
Tags: blog-writing, usability, web-writing, writing on 2007-12-25 and saved by7 people -All Annotations (0) -About
more fromwww.useit.com
-
Journalists have long adhered to the inverse approach: start the article by
telling the reader the conclusion ("After long debate, the Assembly voted to
increase state taxes by 10 percent"), follow by the most important supporting
information, and end by giving the background. This style is known as the
inverted pyramid for the simple reason that it turns the traditional
pyramid style around. Inverted-pyramid writing is useful for newspapers
because readers can stop at any time and will still get the most important
parts of the article. -
On the Web, the inverted pyramid becomes even more important since we know
from several user studies that users don't scroll,(*) so they will very
frequently be left to read only the top part of an article.
10 Ways to Eliminate the Echo Chamber ~ Chris Pirillo
how to be original and creative in blogging
Tags: advice, blog-writing, blogging, blogosphere, critical-thinking, cyber-culture, echo-chamber, writing on 2007-12-25 and saved by3 people -All Annotations (0) -About
more fromchris.pirillo.com
-
When you force yourself to do something that you don’t understand, the results might be messy - but they’ll be genuine.
Coding Horror: Thirteen Blog Clichés
Tags: advise, blog-writing, blogging, writing on 2007-12-25 and saved by9 people -All Annotations (0) -About
more fromwww.codinghorror.com
-
The Useless Calendar Widget
-
Random Images Arbitrarily Inserted In Text
One of the cardinal rules of web writing is to avoid large blocks of text. There are plenty of excellent web writing guides that exhort you to break up your text, using bullets, numbered lists, quotes, paragraph breaks, images-- anything, anything to avoid creating an intimidating wall of dense, impenetrable text. -
As the old adage goes, a picture is worth a thousand words. But you
should no more insert a random image into your writing than you would insert a thousand
random words into your writing. I don't care how beautiful your photographs are, it's a terrible, irresponsible practice that distracts and harms readability. -
No Information on the Author
-
Blogs work because they're simple. When we
clutter up our blogs with a zillion widgets,
features, and add-ons, we're destroying an essential part of what makes blogs worthwhile.

-
And do your readers really want to see pictures of the last 10 visitors to your
blog? -
Citing your references and influences is a great and necessary thing, but obsessively
listing every single blog you read-- the so-called "blogroll"-- is just noise. -
The reality is that tag cloud visualizations are chaotic, noisy,
and unusable. Keep the tagging, lose the cloud. A simple sorted list of tags, along
with the number of posts associated with each tag, is much more effective. -
It is almost never in the reader's interest to see advertisements, so my advice is to tread very lightly, and be respectful of your audience. Bad advertising is so prevalent that if you take the time to advertise responsibly, you may find that readers appreciate you for it.
-
This Ain't Your Diary
-
It's OK to be yourself; at some level, it is a cult of personality: people are reading not only because your content
is useful to them, but because they like you. It's normal to inject a regular dose of yourself into the conversation.
But like Tabasco sauce and other powerful seasonings, a little YOU goes a long way. A really long way. Write accordingly. -
Sorry I Haven't Written in a While
If you haven't posted anything new to your blog in a while, don't waste our time with apologies. Just write! The best apology is new and improved content. Maybe with a wee bit more consistency this time, though. -
Blogging About Blogging
I find meta-blogging -- blogging about blogging -- incredibly boring. -
if everyone else is talking about it, that means you should
avoid talking about it. Switch things up. Seek out uncommon sites with
unique information. Dig down to original sources -
If all you can find to talk about is what's already popular, you're not trying hard enough. Form your own opinion. Do your own research. Go out of your way to blaze a new trail and create something we haven't already seen hundreds of times before.
-
Top (n) Lists
Yes, exactly like this one.
The problem with Top (n) Lists is that they become
a substitute for critical thinking, -
No Comments Allowed
-
The sum total of community contributions is far more useful than any one thing you'll ever write.
-
Besides, It's an open secret in the blogging community that the comments are often better than the original blog entry itself.
Blog Usability: Top 10 Weblog Design Mistakes (Jakob Nielsen's Alertbox)
excellent tips on blog writing and design
Tags: blogging, tutorial, usability, writing on 2007-12-24 and saved by88 people -All Annotations (4) -About
more fromwww.useit.com
-
That said, the basic rationale for "about us" translates directly into the need for an "about me" page on a weblog: users want to know who they're dealing with.
-
2. No Author Photo
Even weblogs that provide author bios often omit the author photo. A photo is important for two reasons:- It offers a more personable impression of the author. You enhance your credibility by the simple fact that you're not trying to hide. Also, users relate more easily to somebody they've seen.
- It connects the virtual and physical worlds. People who've met you before will recognize your photo, and people who've read your site will recognize you when you meet in person
- It offers a more personable impression of the author. You enhance your credibility by the simple fact that you're not trying to hide. Also, users relate more easily to somebody they've seen.
-
Your posting's title is microcontent and you should treat it as a writing project in its own right. On a value-per-word basis, headline writing is the most important writing you do.
Descriptive headlines are especially important for representing your weblog in search engines, newsfeeds (RSS), and other external environments. In those contexts, users often see only the headline and use it to determine whether to click into the full posting. -
4. Links Don't Say Where They Go
Many weblog authors seem to think it's cool to write link anchors like: "some people think" or "there's more here and here."
Remember one of the basics of the Web: Life is too short to click on an unknown. Tell people where they're going and what they'll find at the other end of the link.
Generally, you should provide predictive information in either the anchor text itself or the immediately surrounding words. You can also use link titles for supplementary information that doesn't fit with your content. -
Highlight a few evergreens in your navigation system and link directly to them.
-
Also, remember to link to your past pieces in newer postings. Don't assume that readers have been with you from the beginning; give them background and context in case they want to read more about your ideas.
-
6. The Calendar is the Only Navigation
A timeline is rarely the best information architecture, yet it's the default way to navigate weblogs. Most weblog software provides a way to categorize postings so users can easily get a list of all postings on a certain topic. Do use categorization, but avoid the common mistake of tagging a posting with almost all of your categories. Be selective. Decide on a few places where a posting most belongs. -
8. Mixing Topics
If you publish on many different topics, you're less likely to attract a loyal audience of high-value users. -
10. Having a Domain Name Owned by a Weblog Service
Having a weblog address ending in blogspot.com, typepad.com, etc. will soon be the equivalent of having an @aol.com email address or a Geocities website: the mark of a naïve beginner who shouldn't be taken too seriously.
Write Articles, Not Blog Postings (Jakob Nielsen's Alertbox)
Tags: blogging, jakob-nielsen, to-read, writing on 2007-12-24 and saved by23 people -All Annotations (1) -About
more fromwww.useit.com
-
You probably already know my own Internet strategy, so it might not surprise you that I recommended that he should instead invest his time in writing thorough articles that he published on a regular schedule. Given limited time, this means not spending the effort to post numerous short comments on ongoing blogosphere discussions.
-
Blog postings will always be commodity content: there's a limit to the value you can provide with a short comment on somebody else's work. Such postings are good for generating controversy and short-term traffic, and they're definitely easy to write. But they don't build sustainable value.
-
What matters is that the user experience is that of immersion in comprehensive treatment of a topic, as opposed to a blog-style linear sequence of short, frequent postings commenting on the hot topic of the day. It doesn't matter what software is used to host the content, the distinctions are:
- in-depth vs. superficial
- original/primary vs. derivative/secondary
- driven by the author's expertise vs. being reflectively driven by other sites or outside events
- in-depth vs. superficial
-
If you're an expert who wants to live from adding to the world's knowledge, you must go beyond the mainstream Web model of single page visits driven by search traffic. It's easy enough to build a website that freeloaders will use, but that shouldn't be your approach. You must change the game and create content that's so valuable that business users are willing to pay for it.
You should also focus on material that lower-ranked content contributors can't easily create in their spare time.
Both of these needs are met when you produce in-depth content. -
Why are paying customers (the people who matter) attracted by detailed information? Because systematic and comprehensive coverage is more actionable. It also protects them against the risk of losses caused when something important is overlooked.
-
In-depth content provides more value in less time than numerous superficial postings. That's why business customers have empirically been willing to pay, and that's why you should emphasize fewer, better pieces as your content strategy.
-
For most sites, the content is not the point. Instead, you want to answer customers' questions as rapidly as possible so that they'll advance in the sales cycle and start buying (or donate, or sign up for your newsletter, or whatever else you want them to do).
-
People looking for the quick hit and free advice are not your customers. Let them eat cake; let them read Wikipedia.
-
Still, even if you run an expertise-driven site, you should comply with the bulk of content usability guidelines: be as brief as you can; use bulleted lists and highlighted keywords; chunk the material; and use descriptive headings, subheads, and hyperlinks. The small percentage of users who are qualified prospects still read in an F-pattern, so a headline's first words are more important than its last words, just as they are for normal sites.
Writing, Briefly - by paul graham
Tags: blogging, paul-graham, suggestions, writing on 2007-11-20 and saved by9 people -All Annotations (0) -About
more frompaulgraham.com
» How Does a Bestseller Happen? A Case Study in Hitting #1 on the New York Times
Tags: bloggin, popularity, writing on 2007-08-12 and saved by2 people -All Annotations (0) -About
more fromwww.fourhourworkweek.com
Cites & Insights 6:14 - The Lazy Man's Guide to Productivity
Tags: productivity, writing on 2007-05-10 -All Annotations (0) -About
more fromcitesandinsights.info
How to Use English Punctuation Correctly - WikiHow
Tags: english, grammer, language, punctuation, writing on 2007-04-06 and saved by21 people -All Annotations (0) -About
more fromwww.wikihow.com
Conversational writing kicks formal writing's ass , by Kathy Sierra at Headrush - Creating Passionate Users:
Tags: advice, howto, learning, writing on 2007-03-14 and saved by12 people -All Annotations (1) -About
more fromheadrush.typepad.com
- Write like you talk; Don't talk like you write.post by eyalnow on 2007-03-14
-
If you want people to learn and remember what you write, say it conversationally. This isn't just for short informal blog entries and articles, either. We're talking books. Assuming they're meant for learning, and not reference, books written in a conversational style are more likely to be retained and recalled than a book on the same topics written in a more formal tone. Most of us know this intuitively, but there are some studies to prove it.
-
What most people mean when they say "write the way you talk" is something like, "the way you talk when you're explaining something to a friend, filtering out the 'um', 'you know', and 'er' parts, and editing for the way you wish you'd said it."
-
I've talked about the danger of writing a book from the perspective of what it will do for you vs. what it means for the user in How to write a non-fiction bestseller.
-
Much of the time, it's an indication that the author is thinking way too much about himself, and how he will be perceived.
-
Sometimes it's simply because so many technical books are written that way, and it's just conventional inertia ("if the other books are written like that, and they sell, this must be the way it's done")
-
"In five out of five studies, students who learned with personalized text performed better on subsequent transfer tests than students who learned with formal text.
-
"... people read a story differently and remember different elements when the author writes in the first person (from the "I/we" point of view) than when the author writes in the third person (he, she, it, or they).
-
Research summarized by Reeves and Nass (1996) shows that, under the right circumstances, people "treat computers like real people."
-
So one of the theories on why speaking directly to the user is more effective than a more formal lecture tone is that the user's brain thinks it's in a conversation, and therefore has to pay more attention to hold up its end!
-
your brain wakes up when its being talked with as opposed to talked at. And the word "you" can sometimes make all the difference.
-
And from another perspective, consider what former Wired editor Constance Hale wrote in Sin and Syntax:
"The second-person pronoun (you) lets the author hook the reader as if in conversation. Call it cozy. Call it confiding. You is a favorite of the Plain English folks, who view it as an antidote to the stiff impersonality of legalese and urge bureaucrats to write as if speaking to the public...
-
v
irtually all brains learn the same way--through emotional response (which in turn triggers the brain to pay more attention and possibly record to long-term storage).
>
> And engaging in a conversation has the potential to turn up the emotional gain much more than a dry, lifeless text or lecture. -
If your brain had a bumper sticker, it would say:
I heart conversation.
-
Posted by Kathy Sierra on September 6, 2005 | Permalink
Notation: * = Private bookmark and comment|… = Clipping [?] | … = Public highlight [?]


