惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

S
Securelist
C
CERT Recently Published Vulnerability Notes
Forbes - Security
Forbes - Security
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
L
LINUX DO - 最新话题
The Hacker News
The Hacker News
Google Online Security Blog
Google Online Security Blog
SecWiki News
SecWiki News
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
The Last Watchdog
The Last Watchdog
S
Schneier on Security
T
Troy Hunt's Blog
N
News | PayPal Newsroom
cs.CL updates on arXiv.org
cs.CL updates on arXiv.org
Schneier on Security
Schneier on Security
P
Privacy & Cybersecurity Law Blog
T
Tor Project blog
T
Threatpost
Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
A
Arctic Wolf
S
Secure Thoughts
P
Proofpoint News Feed
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
Security Latest
Security Latest
Scott Helme
Scott Helme
Security Archives - TechRepublic
Security Archives - TechRepublic
Latest news
Latest news
PCI Perspectives
PCI Perspectives
cs.AI updates on arXiv.org
cs.AI updates on arXiv.org
Hacker News - Newest:
Hacker News - Newest: "LLM"
L
LINUX DO - 热门话题
P
Palo Alto Networks Blog
www.infosecurity-magazine.com
www.infosecurity-magazine.com
G
GRAHAM CLULEY
V2EX - 技术
V2EX - 技术
Google DeepMind News
Google DeepMind News
Project Zero
Project Zero
V
Vulnerabilities – Threatpost
T
Threat Research - Cisco Blogs
Webroot Blog
Webroot Blog
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
N
News and Events Feed by Topic
TaoSecurity Blog
TaoSecurity Blog
大猫的无限游戏
大猫的无限游戏
T
Tenable Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
V
Visual Studio Blog
H
Hacker News: Front Page
Simon Willison's Weblog
Simon Willison's Weblog
AWS News Blog
AWS News Blog

fantasai: Weblog

Change of Affiliation Thoughts on the W3C’s May 2020 Advisory Board Election fantasai 69: Process 2020 Revision Thoughts on the W3C’s May 2019 Advisory Board Election Running for the W3C Advisory Board Designing CSS Thoughts on the May 2018 W3C Advisory Board Election Environmental Sustainability Recommendations for Mountain View Buildings fantasai 63: The Way of Music fantasai 62: How To Wash Dishes Open Letter on the Iran Nuclear Deal Recipe for a Minimum Viable Kitchen Creating a Paid Contributor Agreement for Mozilla On Brendan Eich and the Separation of Concerns fantasai 57: 2012 TAG Election Endorsements fantasai 56: Approaching UTR50 Evolution of CSS Layout Job Description of a Standards Engineer fantasai 52: about:csswg fantasai 53: W3C Process Holes fantasai 51: about:fantasai fantasai 50: Hiatus E Pluribus Unum Towards a Unified Ruby Model Creating the Future of CSS Testing (2011 Edition) Creating the Future of CSS Testing (2009 Edition) CSS2.1 and the Case for Collaborative Testing Introducing Brad Kemper, CSSWG Invited Expert fantasai 44: Layout Is Expensive CSS Working Group Charter 2008 fantasai 42: Riddle of the Universe Pulling Back the Curtain: Opening Up the CSS Working Group What is the CSS Working Group doing? The True Story of mpt and fantasai fantasai 38: Long Vacation fantasai 37: CSS3 Text Evolutions fantasai 36: What is Mozilla? fantasai 34: Empty fantasai 33: When to use PDF fantasai 32: Revised CSS3 Text fantasai 31: The Art of Semantics fantasai 30: Travel Notes fantasai 29: Filibuster Frist fantasai 28: UTN 22 fantasai 27: SSSS fantasai 26: CSS and Multi-Script Text fantasai 25: Free As in Freedom fantasai 24: The Law of Hospitality fantasai 23: Organizing the Documentation Effort fantasai 22: Yom Kippur fantasai 21: Firefox and Switching Styles Link Types for RSS and Atom Feeds fantasai 19: An Absence of Aesthetics Sitting on the Outside, Looking Up fantasai 17: A Touch of Class fantasai 16: Task Force fantasai 15: W3 fantasai 13: A Stitch in Time fantasai 11: What Is Love fantasai 10: Reviewer at Small fantasai 09: Losing it fantasai 08: Personality Type fantasai 07: Happiness fantasai 06: Moving fantasai 05: Black Tuesday fantasai 03: Words of Wisdom fantasai 02: Big and Small fantasai 01: Why validate your pages? fantasai 00: Experiment
Content and Hype (English Composition for Marketers)
2003-10-31 · via fantasai: Weblog

2003-10-30 – 2003-12-08

Since the launch of Mozilla's new courtship of end-users, marketing hype has slowly infiltrated the hapless mozilla.org website. Rather than eschewing marketing obfuscation, our eager advocates embrace it because, of course, this is progress! Jwz was referring to technical documents, not marketing ones—marketing is supposed to be hype; his guidelines therefore don't apply. Or so one would assume.

Eschew marketing obfuscation.

Actually, this is some of the best marketing advice I've ever read. Take a closer look at the sentence. It doesn't say "Eschew marketing"; it says "Eschew marketing obfuscation."

One of the things that people seem to like best about the existing content on mozilla.org is that it is written by people, for people, without bluster or self-promotion.

Are you excited about this product? Yes? Then show it! The most convincing marketing is by people who are enthusiastic about what they're promoting. But don't chatter at me with repetitive nonsense, don't tell me that it's the greatest thing since the kitchen sink, tell me why it's great. Let me see for myself why it's so worthy.

When describing something, don't tell people how great it is. Don't tell them how useful it is. Tell them what it does. Tell them what it's for.

In other words, don't tell me how great it is. Tell me how it's great. Don't tell me how useful it is, tell me how it's useful.

Don't use buzzwords. Instead, say what you mean. Never use a long word where a short one would do. If it's possible to cut a word out, cut it out.

A visitor is there to get information, not words. Don't pad it out with fluff. Don't replace it with hype. Fluff just takes up room, and hype is not fulfilling. It wastes the reader's time and dilutes the message you're trying to send. The visitor wants to know why this product is worth using—that's what he's here for—but he doesn't want to wade through marketing BS or irrelevant details to figure it out.

First Impressions

Let's take a look at an example of what not to do:

It sounds like "we" thinks it's a fantastic group of people. They're innovators and producers, advocates and partners, a community of developers, and look at all the powerful features they've implemented in all their advanced products!

But...

  • Who's "we"?
  • What is the mozilla organization?
  • For what purpose does it exist?
  • How is it run?
  • Who's in charge?
  • What's the history behind it?

The only thing I've learned about "us" is the kinds of products it makes (which I could've figured out from the Products pages), what features they have (which I could have also learned from the Products pages), and the fact that it's an open source project (useful enough, since it's hardly mentioned anywhere else on the site). I haven't learned anything about the organization itself, which is ostensibly why I'm reading this page in the first place.

The description of Mozilla 1.5 excellently summarizes the product's most noteworthy features—but it belongs in the Mozilla 1.5 product description page, not here. Here it only increases the sense of unrestrained advertising: "just keep plugging the product line".

Of course, this is all assuming I read the doc. By the time I've read the first paragraph of this marketing riff, I've already formed a judgement about the document and how I should read it: it's mostly useless hype, so I'm only going to skim it to get an idea of the general scope and gist. My impression (and therefore my method) doesn't change further down. I'm catching the headings, the linked phrases, and a surface impression of the contents, mainly some babbling about products and features. The buzzwords in the introduction are all conveniently highlighted for me, no doubt so I can compare word lists with mozilla.org's competitors(?) later...

The end result? Any real information buried in all this marketing obfuscation (such as the link to the mission statement) gets lost, and I've come away

  • without having learned anything useful about the Mozilla organization and
  • with an impression of the organization as an empty collection of buzzwords.

Needless to say, the document has utterly failed in its purpose.

Answering the Question

So it doesn't look like I'm unfairly bashing this one document, let's look at Ben Goodger's "Why use Firebird" article.

This document gives a very comperehensive list of Mozilla Firebird's features — there is a lot of good, solid content here. However, there are too many details. The article is for presenting Mozilla Firebird's features, not for explaining, in detail, how to use them. Also, there is some marketing fluff that could be trimmed out.

Feature descriptions like these should be "short, sweet, and to the point": enough to demonstrate to the reader what the feature is and why it's useful, but not enough to waste his patience or lose his attention before the next heading.

So what happens when a marketing doc meets an editor?

This trimmed-down version is based off a draft Firebird home page by Tristan Nitot. I've just lifted more content from Goodger's article and the current Mozilla Firebird home page to make it more complete (and fixed a few minor grammar and style problems).

Rhetoric vs. Eloquence

To get into the higher A range, writing must have eloquence both in thought and expression.

Compare these three Tabbed Browsing blurbs.

I won't go through a complete line-by-line analysis, but let's look at how the original description has been improved:

The "trimmed" version has cut out a lot of useless verbiage:

  • Uninformative hyperbole: "easier than ever before", "best Tab-Browsing around", etc.
  • Repetition: "Tab-Browsing changes the way you use the internet" vs. "Tab-Browsing is a revolutionary change to the way you browse the internet", etc.
  • Pointless Points: e.g. "Tab-Browsing is central to the Mozilla Firebird browser"—This only seems to be there to take the edge off an abrupt (awkward) transition.
  • The TiVo analogy: it adds little insight into Tabbed Browsing—and how many people know what TiVo is, anyway?

The result is less than half the length of the original and much more focused.

Cut-n'-paste, however, cannot compensate for missing logic structure. While it's no longer necessary to sift through the excess prose, the poor ordering and connection of ideas forces the reader to infer ideas that ought to be clearly presented.

Besides the fluency of thought—and most likely because of it—the paragraph flows fluidly at the rhetorical level as well.

The details make the difference between the good and the great

A little careful tweaking can make the last one even better:

Open multiple pages in a single window and load links in the background — tabbed browsing is a fast and convenient new way to browse the web. By holding down Ctrl when clicking a link or using your middle mouse button (if you have one), you can open links in background tabs while you read a web page and continue to the links when you're done. Pages are already loaded when you need them, making the web feel faster even over slow connections.

What I changed and why:

  • A lot of things can be "fast and convenient". Inverting the first sentence lets us present tabbed browsing's two specific advantages first. This catches the reader's attention. It also lets "fast and convenient" grab a stronger conceptual hold when the phrase is read because one can understand why tabbed browsing is fast and convenient.

  • Ordinarily, I would not put technical instructions (keyboard shortcuts and the like) in a marketing description. However, this is a key feature, and how to use it is not obvious. Putting it in here

    • shows the reader how easy and convenient tabbed browsing is
    • makes it easy to try out right away, without searching the help file (which people don't do anyway)

In summary

What should you take from this lesson?

  • Eschew marketing obfuscation.
  • Don't let advertising be the main goal of the design: helping the visitor find the information s/he's looking for is the main goal. Advertising should be just a side effect.
  • In other words, Don't tell them what you want them to hear. Tell them what they want to know.
  • Answer the question.
  • Short, sweet, and to the point. (It's a cliché. You'll remember it. So don't forget it.)

Finally, hats off to the authors for providing such excellent examples. Please don't kill me for using them... >.<;;

A professional attitude means being honest and straightforward: it means presenting yourself well. It does not mean pretending to be what you're not.