Writer's Block
-
I start with an outline. Rephrasing your opening a bit:
Overview
The Nkomati Production KPI Reporting application helps maintain and report production KPI data. Static and daily data are captured. Reports may be printed on schedule or on demand.
Data Captured
Scheduled Reports
On-Demand Reports
Data Maintenance
Software Zen:
delete this;Cool, thanks. That's perfect to start with. However, a suitable compliment to static data still bothers me. Daily is very descriptice, but I'd like to find something more general than daily, but dynamic date seems to technical for financial users. Moving data?
-
1. Make notes of everything you want to say. 2. Burn the notes, and write what the reader needs to know, instead.
I wanna be a eunuchs developer! Pass me a bread knife!
I like.
-
How about 'I have an adult rated fantasy' ?
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
-
I love writing, and often get quite carried away once I get started, but right now I can't get started. I need to deliver some documentation for a reporting application I've just delivered. It includes some KPI reports, KPI 'master' data, and daily figures (and their totals), with capture and edit screens for all data. I'm stuck on my opening line, and I think once I get past that, I'll be cruising nicely. Here is is, please attack it and leave me some pieces to collage a better one with: The Nkomati Production KPI Reporting application provides production KPI reports on demand, and on schedule, and also facilitates the maintenance and capture of static and daily data that these reports are built on.
She breathed heavily, grunting in delight as he...You can take it from this point....45 ACP - because shooting twice is just silly
-----
"Why don't you tie a kerosene-soaked rag around your ankles so the ants won't climb up and eat your candy ass..." - Dale Earnhardt, 1997
-----
"The staggering layers of obscenity in your statement make it a work of art on so many levels." - J. Jystad, 2001 -
Purchase our software, now with free pr0nz!!! :laugh:
He who makes a beast out of himself gets rid of the pain of being a man.
-
Cool, thanks. That's perfect to start with. However, a suitable compliment to static data still bothers me. Daily is very descriptice, but I'd like to find something more general than daily, but dynamic date seems to technical for financial users. Moving data?
I have a feeling the term 'static' is a little technical too. For users in the financial industry, would the terms 'fixed' (for static) and 'variable' (for daily or dynamic) work?
Software Zen:
delete this; -
I love writing, and often get quite carried away once I get started, but right now I can't get started. I need to deliver some documentation for a reporting application I've just delivered. It includes some KPI reports, KPI 'master' data, and daily figures (and their totals), with capture and edit screens for all data. I'm stuck on my opening line, and I think once I get past that, I'll be cruising nicely. Here is is, please attack it and leave me some pieces to collage a better one with: The Nkomati Production KPI Reporting application provides production KPI reports on demand, and on schedule, and also facilitates the maintenance and capture of static and daily data that these reports are built on.
-
I love writing, and often get quite carried away once I get started, but right now I can't get started. I need to deliver some documentation for a reporting application I've just delivered. It includes some KPI reports, KPI 'master' data, and daily figures (and their totals), with capture and edit screens for all data. I'm stuck on my opening line, and I think once I get past that, I'll be cruising nicely. Here is is, please attack it and leave me some pieces to collage a better one with: The Nkomati Production KPI Reporting application provides production KPI reports on demand, and on schedule, and also facilitates the maintenance and capture of static and daily data that these reports are built on.
-
She breathed heavily, grunting in delight as he...You can take it from this point....45 ACP - because shooting twice is just silly
-----
"Why don't you tie a kerosene-soaked rag around your ankles so the ants won't climb up and eat your candy ass..." - Dale Earnhardt, 1997
-----
"The staggering layers of obscenity in your statement make it a work of art on so many levels." - J. Jystad, 2001A chick who grunts doesn't inspire me. Now, She breathed heavily, moaning in delight as he...
Software Zen:
delete this; -
A chick who grunts doesn't inspire me. Now, She breathed heavily, moaning in delight as he...
Software Zen:
delete this;Gary Wheeler wrote:
She breathed heavily, moaning in delight as he...
slowly took his long cable and plugged it into her Ethernet port. She gasped at the sight of his obvious technical prowess, while he ... Geekrotica
:..::. Douglas H. Troy ::..
Bad Astronomy |VCF|wxWidgets|WTLmodified on Wednesday, November 25, 2009 11:39 AM
-
She breathed heavily, grunting in delight as he...You can take it from this point....45 ACP - because shooting twice is just silly
-----
"Why don't you tie a kerosene-soaked rag around your ankles so the ants won't climb up and eat your candy ass..." - Dale Earnhardt, 1997
-----
"The staggering layers of obscenity in your statement make it a work of art on so many levels." - J. Jystad, 2001 -
It would seem your faith in the Lounge as a place of serious response was sorely misplaced. ;P //L
Yes, but is anyone surprised ?
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
-
I love writing, and often get quite carried away once I get started, but right now I can't get started. I need to deliver some documentation for a reporting application I've just delivered. It includes some KPI reports, KPI 'master' data, and daily figures (and their totals), with capture and edit screens for all data. I'm stuck on my opening line, and I think once I get past that, I'll be cruising nicely. Here is is, please attack it and leave me some pieces to collage a better one with: The Nkomati Production KPI Reporting application provides production KPI reports on demand, and on schedule, and also facilitates the maintenance and capture of static and daily data that these reports are built on.
Ok, since most of the standard jokes have been covered, I'll chime in with some serious advice. I'm more comfortable writing fiction than documentation, but some of the same techniques apply. A sentence has to accomplish two things: Provide the necessary information, and sound good. If you feel silly reading it aloud, or are mentally saying "Blah blah blah" as you read part of it, then it needs work.
Brady Kelly wrote:
The Nkomati Production KPI Reporting application provides production KPI reports
Need a synonym there... Sure, it makes sense, but it sounds like "The input entry field is for input entry." I don't know what KPI stands for, but just partially-expanding that acronym might improve the sound of it. Anyway, here's my shot at it... The Nkomati Production KPI Reporting application is a data processing tool that provides both scheduled and on-demand reports, while also facilitating the maintenance and capture of the underlying data. Same facts, rearranged a bit, with less repetition. The "static and daily" part might be better in a subsequent sentence or paragraph.
Proud to have finally moved to the A-Ark. Which one are you in? Developer, Author (Guardians of Xen)
-
Ok, since most of the standard jokes have been covered, I'll chime in with some serious advice. I'm more comfortable writing fiction than documentation, but some of the same techniques apply. A sentence has to accomplish two things: Provide the necessary information, and sound good. If you feel silly reading it aloud, or are mentally saying "Blah blah blah" as you read part of it, then it needs work.
Brady Kelly wrote:
The Nkomati Production KPI Reporting application provides production KPI reports
Need a synonym there... Sure, it makes sense, but it sounds like "The input entry field is for input entry." I don't know what KPI stands for, but just partially-expanding that acronym might improve the sound of it. Anyway, here's my shot at it... The Nkomati Production KPI Reporting application is a data processing tool that provides both scheduled and on-demand reports, while also facilitating the maintenance and capture of the underlying data. Same facts, rearranged a bit, with less repetition. The "static and daily" part might be better in a subsequent sentence or paragraph.
Proud to have finally moved to the A-Ark. Which one are you in? Developer, Author (Guardians of Xen)
Ian Shlasko wrote:
I don't know what KPI stands for
Key Performance Indicators. I envy you for not knowing that.
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
-
John Simmons / outlaw programmer wrote:
grunting in delight
Grunting is what livestock do.
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
If she's grunting, she's visiting her animal side. Yummy...
.45 ACP - because shooting twice is just silly
-----
"Why don't you tie a kerosene-soaked rag around your ankles so the ants won't climb up and eat your candy ass..." - Dale Earnhardt, 1997
-----
"The staggering layers of obscenity in your statement make it a work of art on so many levels." - J. Jystad, 2001 -
I have a feeling the term 'static' is a little technical too. For users in the financial industry, would the terms 'fixed' (for static) and 'variable' (for daily or dynamic) work?
Software Zen:
delete this;Probably. They aren't old enough to be stuck on using the term Master Files. :~
-
Yes, but is anyone surprised ?
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
Not even me. I like a good explosion of comments, helpful or not.
-
Ok, since most of the standard jokes have been covered, I'll chime in with some serious advice. I'm more comfortable writing fiction than documentation, but some of the same techniques apply. A sentence has to accomplish two things: Provide the necessary information, and sound good. If you feel silly reading it aloud, or are mentally saying "Blah blah blah" as you read part of it, then it needs work.
Brady Kelly wrote:
The Nkomati Production KPI Reporting application provides production KPI reports
Need a synonym there... Sure, it makes sense, but it sounds like "The input entry field is for input entry." I don't know what KPI stands for, but just partially-expanding that acronym might improve the sound of it. Anyway, here's my shot at it... The Nkomati Production KPI Reporting application is a data processing tool that provides both scheduled and on-demand reports, while also facilitating the maintenance and capture of the underlying data. Same facts, rearranged a bit, with less repetition. The "static and daily" part might be better in a subsequent sentence or paragraph.
Proud to have finally moved to the A-Ark. Which one are you in? Developer, Author (Guardians of Xen)
Thanks, good advice and example. The target audience are all familiar with KPI though. It stands for Key Performance Indicator, and is a high level figure for management to assess the performance of e.g. a department, in a month. Different functional areas have different KPI's, e.g. a mine pit will have 'tons of ore hauled', where health and safety will have 'No. of incidents'.
-
Ian Shlasko wrote:
I don't know what KPI stands for
Key Performance Indicators. I envy you for not knowing that.
Christian Graus Driven to the arms of OSX by Vista. Read my blog to find out how I've worked around bugs in Microsoft tools and frameworks.
I've made an effort to stay out of management :)
Proud to have finally moved to the A-Ark. Which one are you in? Developer, Author (Guardians of Xen)
-
Thanks, good advice and example. The target audience are all familiar with KPI though. It stands for Key Performance Indicator, and is a high level figure for management to assess the performance of e.g. a department, in a month. Different functional areas have different KPI's, e.g. a mine pit will have 'tons of ore hauled', where health and safety will have 'No. of incidents'.
Gotcha. The point, though, is that you could take parts of that to make it read a little nicer... This is just about readability, not actual information... Instead of saying: "The Something KPI Report application produces KPI reports...", You could say: "The Something KPI Report application produces performance reports..."
Proud to have finally moved to the A-Ark. Which one are you in? Developer, Author (Guardians of Xen)
