Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Post History

50%
+0 −0
Q&A How can I make a case for toning down the "rah rah" marketing tone around technical content?

Summary Starting from the position that -- with modern web delivery -- the line between technical communication and marketing content is fading (as all the content is available to business and tec...

3 answers  ·  posted 7y ago by Sharon M‭  ·  last activity 5y ago by System‭

#3: Attribution notice added by user avatar System‭ · 2019-12-08T07:57:39Z (about 5 years ago)
Source: https://writers.stackexchange.com/q/33270
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision by user avatar Sharon M‭ · 2019-12-08T07:57:39Z (about 5 years ago)
## Summary

Starting from the position that -- with modern web delivery -- the line between technical communication and marketing content is fading (as all the content is available to business and technical readers via search) and it is desirable to have a more consistent tone across the organization... how can I (as an experienced technical writer) work with the "market-y"-leaning folks to make that tone more consistent?

## Considerations

The idea is to minimize a jarring difference in tone. We're already unifying product terminology across communication channels.

I'm not looking for reiteration of "know your audience." I'm trying to understand/reach my modern audience.

In the interest of making a case... I'd especially like some help describing the traditional differences between marcomm and techcomm, beyond than my default reaction to marcomm as "fluff" and "rah rah" and "jargon-filled." There are legitimate reasons marcomm has traditionally written the way "they" have, I'm just not fluent in them. I want to build bridges, not walls ;-)

Typical scenario: The "front of house"/marcomm type colleagues want to expand on introductory material in technical doc, because potential customers might come across the technical content and need some context and market placement.

Related to: [Should software product release notes be in marketing voice or technical voice? (software documentation)](https://writing.stackexchange.com/q/33225/29548)

#1: Imported from external source by user avatar System‭ · 2018-02-14T16:13:00Z (almost 7 years ago)
Original score: 10