: Re: How to eliminate standoff between "Lengthy" vs "Concision"? Often while writing a software requirement/change-request documentation, I need to include the quoted requirements descriptively, the impacted

It sounds like there may be more than one audience for your documentation, and the struggle you're having is trying to optimize your output(s) to appease as many as possible. Furthermore, it sounds like you know this is the issue, since you have tried differing strategies to reach those goals.

To tackle the stand-off you might just have to be willing to cut the Gordian knot: stop trying please everyone. It's just not a good use of your time and talents.

An executive summary has its place. An overview of changes and their relations to the road-map are necessary for team effort to be optimized. But at a certain point you are throwing effort into a job that the reader themselves should be doing. (Taking a big step back: If you are required to output volumes of documentation that no-one reads because they don't have time to do so, then this is a management issue.)

Load Full (0)

: You could give subtle mannerisms which are unique to each one (such as over-blinking, or a stutter). When they, have those mannerisms play out so that the reader knows which one is speaking

@Miguel976

Load Full 0 Comments

: The conventional way to write a nickname is in quotation marks between the first name and the surname. For example, E. E. â€œDocâ€ Smith. Either Babs Benge or Barbara â€œBabsâ€ Benge works,

@Miguel976

Load Full 0 Comments

: How do I price the ghostwriting of a memoir? I'm a professional writer, but I've never written a memoir. I've been asked to submit a proposal to ghostwrite a memoir. The person whose memoir

@Miguel976

Load Full 2 Comments

: How to balance a blog post that is neither too detailed nor too surface level? While writing blog post mostly on technical articles, I often come to dilema that does my post is too detailed

: Re: How to eliminate standoff between "Lengthy" vs "Concision"? Often while writing a software requirement/change-request documentation, I need to include the quoted requirements descriptively, the impacted

More posts by @Miguel976

: You could give subtle mannerisms which are unique to each one (such as over-blinking, or a stutter). When they, have those mannerisms play out so that the reader knows which one is speaking

: The conventional way to write a nickname is in quotation marks between the first name and the surname. For example, E. E. â€œDocâ€ Smith. Either Babs Benge or Barbara â€œBabsâ€ Benge works,

: How do I price the ghostwriting of a memoir? I'm a professional writer, but I've never written a memoir. I've been asked to submit a proposal to ghostwrite a memoir. The person whose memoir

: How to balance a blog post that is neither too detailed nor too surface level? While writing blog post mostly on technical articles, I often come to dilema that does my post is too detailed

Login to post a comment!

0 Comments

Back to top

: Re: How to eliminate standoff between "Lengthy" vs "Concision"? Often while writing a software requirement/change-request documentation, I need to include the quoted requirements descriptively, the impacted

More posts by @Miguel976

: You could give subtle mannerisms which are unique to each one (such as over-blinking, or a stutter). When they, have those mannerisms play out so that the reader knows which one is speaking

: The conventional way to write a nickname is in quotation marks between the first name and the surname. For example, E. E. â€œDocâ€ Smith. Either Babs Benge or Barbara â€œBabsâ€ Benge works,

: How do I price the ghostwriting of a memoir? I'm a professional writer, but I've never written a memoir. I've been asked to submit a proposal to ghostwrite a memoir. The person whose memoir

: How to balance a blog post that is neither too detailed nor too surface level? While writing blog post mostly on technical articles, I often come to dilema that does my post is too detailed

Login to post a comment!

0 Comments

Back to top

: The conventional way to write a nickname is in quotation marks between the first name and the surname. For example, E. E. â€œDocâ€ Smith. Either Babs Benge or Barbara â€œBabsâ€ Benge works,