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 express this fragment more clearly and concisely?

For the 'who is this application for' section of an application user guide, I have the following alternatives, I'm not happy with either one. How can I convey both elements more clearly and consis...

1 answer  ·  posted 11y ago by marfarma‭  ·  last activity 4y ago by System‭

#3: Attribution notice added by user avatar System‭ · 2019-12-08T02:44:02Z (over 4 years ago)
Source: https://writers.stackexchange.com/q/7271
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision by user avatar marfarma‭ · 2019-12-08T02:44:02Z (over 4 years ago)
For the 'who is this application for' section of an application user guide, I have the following alternatives, I'm not happy with either one. How can I convey both elements more clearly and consisely?

What I want to convey:

1. The business functions related to the specific metric ==\> who in the sense of who might have to deal with the issue
2. Why they would care ==\> The specific issue the the application is meant to resolve

Current:

> The intended audience is anyone tasked to ensure the accuracy of [analytic metric] generated by the their implementation of the [Specific Analytic Software] Platform, whether for [business function A], [business function B], [business function C], or [business function D].

Proposed:

> The intended audience includes personnel tasked with ensuring the accuracy of [analytic metric] sourced from the [Specific Analytic Software] Platform. This information could be included within any of the following: [business function A], [business function B], [business function C], or [business function D].

**Update**

Based on your proposed solutions, here is my current, much improved take:

> This application is for anyone in [business function A], [business function B], [business function C], or [business function D] who compiles [analytic metric] using (ESP). It is designed to help you ensure the accuracy of the [analytic metric] by connecting to ESP to generate and collect, in just a few minutes, related analytic and underlying data that would otherwise take hours to compile. The compiled information is then organised and presented in a way that makes troubleshooting and documenting specific [analytic metric] values easier.

Comments?

#1: Imported from external source by user avatar System‭ · 2013-02-13T21:10:02Z (about 11 years ago)
Original score: 5