IWETHEY v. 0.3.0 | TODO
1,095 registered users | 0 active users | 0 LpH | Statistics
Login | Create New User
IWETHEY Banner

Welcome to IWETHEY!

New Use active voice, not passive.
Your sentences all have a level of passive indirection in them. Readers have to juggle more context to read that. This makes your prose difficult for less fluent readers, for roughly the same reason that people complain about Ashton and lawyers. Let me use the first paragraph for an example:
A high priority for the system is that all users' interaction with data take place in a timeframe which is perceived to be acceptably fast. Specific minimum response speeds in repeatable, measurable time values are not to be specified in this document, or in any subsequent requirements or design document. Instead, the speed requirements for any part of this specification shall conform to the following named categories, roughly in order of total time taken. Keep in mind throughout that any Time category is specified by a maximum set of perceptual constraints; it is perfectly acceptable for any activity to come to completion in less time. Such a time scheme places the burden of measurement firmly on the perception of the end-user, where it should be; however, policy regarding acceptable timeframes remains in the hands of management and similar stakeholders in the requirements process. In particular, this frees measurement of system time from the vagaries of underlying networks, operating systems, and hardware, since these differing subsystems will in turn be factored into the user's perception of the acceptability of the time taken to perform the event or activity. In other words, users on slow links should have lower expectations about system responsiveness, within reason; however, this does not significantly alter the category into which each activity falls.

Let's rewrite that:
It is important that users find the speed of data interaction acceptable. Given that system responsiveness depends on many things outside of programmer control, this and other design documents will not seek to specify exact clock limits. Instead they will specify which category of timeliness specific operations should fall into.

Sure, I left things out. But it is more likely that if you hand it to someone, they will read it. And more importantly, understand it.

Cheers,
Ben
"good ideas and bad code build communities, the other three combinations do not"
- [link|http://archives.real-time.com/pipermail/cocoon-devel/2000-October/003023.html|Stefano Mazzocchi]
New OK, thanks!
Too much Shakespeare, lately.. :)

Many fears are born of stupidity and ignorance -
Which you should be feeding with rumour and generalisation.
BOfH, 2002 "Episode" 10
Expand Edited by tseliot June 24, 2003, 11:19:38 AM EDT
New About the only complaint I have is passive voice.
And Ben stole the thunder. :)

[link|mailto:greg@gregfolkert.net|greg] - IT Grand-Master for Anti-President
[link|http://www.iwethey.org/ed_curry/|REMEMBER ED CURRY!]

THEY ARE WATCHING YOU.
The time has come for you to take the last step.
You must love THEM.
It is not enough to obey THEM.
You must love THEM.

PEACE BEGETS WAR, SLAVERY IS FREEDOM, STRENGTH IN IGNORANCE.
New Second try, edited passive voice:
4.2.2 Acceptable user-interaction times
It is highly important that users find the speed of the system acceptable. However, user perception is highly subjective, and system responsiveness depends on many things outside of developer control. Therefore, this and other design documents will not specify exact clock limits. Instead, each time requirement will specify a category of timeliness, one of the following:

4.2.2.1 Immediate Time.
Users perceive Immediate Time processes as instantaneous. Humans cannot measure them unaided. They do not indicate processing or progress. Examples of Immediate Time activities include:
  • Displaying a character on-screen following a keystroke.

  • Highlighting selected text (of moderate length).

  • Repainting discovered windows.


4.2.2.2 Page Time.
Users notice Page Time processes; however, any delay does not measurably affect their work speed. In most cases, the user offsets any delays with instinctive workflow improvements. Page Time processes must indicate that processing is underway. Examples of Page Time activities include:
  • Opening a new window in a web browser and populating its view.

  • Updating a data objects' primitive properties.

  • Password verification.


4.2.2.3 Analysis Time.
Users notice Analysis Time processes and categorize them as delays; however, they accept the delay, considering it reasonable and necessary to complete a complex task. Analysis Time processes must indicate that processing is underway, and indicate relative progress where possible. Examples of Analysis Time activities include:
  • Retrieval of large or complex tables for display.

  • Updates to multiple similar or interrelated objects.

  • Spell-checking or find-and-replace applied to a large document.


4.2.2.4 Background Time.
Background Time processes are not always noticed by the user, since they do not interrupt their work. They allow other user actions to be performed simultaneously. They must unobtrusively indicate that processing is underway, and indicate relative progress where possible. Examples of Background Time activities include:
  • The actual time between a user clicking 'Send' on an email, and the time that email is delivered.

  • Background printing; that is, the actual time between a user clicking a 'Print' button associated with a document, and the time that document begins or completes printing.

  • The processing of a request which is relegated in a web interface to a "popunder", or background window.


4.2.2.5 Warehouse Time.
Users understand Warehouse Time processes but are not normally affected by them. For example, the user may have knowledge that a process occurs once every twenty-four hours, but is usually able to work without regard to the exact time that process occurs. Such processes have published time specifications, but do not indicate their progress to end users while underway. Server-side processes indicate relative progress where possible to system administrators. Examples of Warehouse Time activities include:
  • Data warehousing activites, in which low-level details are summarized for management-level analysis, usually in another datastore designed specifically for that purpose.

  • Hourly "batch" processes, such as garbage collection, integrity checks, or child property summation for a parent's consumption.

  • Daily "batch" processes, such as automatic payments via credit card, or automated email reminders based on dated triggers.


4.2.2.6 Moderated Time.
Moderated Time processes require the action of a human to complete. They indicate to the user who is responsible for the next step. They either notify the next party or inform the user how they may be notified. Examples of Moderated Time include:
  • Temporary access to subsystems to which the user does not normally have permission.

  • The "posting" of a forum message on a forum which requires all posts be approved by a moderator.

  • "Two-actor" systems which require that users act in concert to perform an activity. Such systems are commonly used to combat fraud.


Many fears are born of stupidity and ignorance -
Which you should be feeding with rumour and generalisation.
BOfH, 2002 "Episode" 10
New *Much* easier to read
===

Implicitly condoning stupidity since 2001.
     Maybe we need a new forum to fit my new job. :( - (tseliot) - (5)
         Use active voice, not passive. - (ben_tilly) - (4)
             OK, thanks! - (tseliot)
             About the only complaint I have is passive voice. - (folkert)
             Second try, edited passive voice: - (tseliot) - (1)
                 *Much* easier to read -NT - (drewk)

Life was hard for the pioneers, but every now and again, someone would get out the fiddle and make it all worse.
40 ms