User Manual Amendments

Customer Group 10

User Manual Amendments


Thank you for providing us with the system's user manual. We are happy to see the user manual was completed on time and have the following comments.

We understand that it many cases, it may have been our fault in being unable to find information relating to a screen or a feature. If this is the case, we trust that you will make every effort to make it less ambiguous, for if we had a problem, we believe our users may too.


General Comments

Overall, we are very impressed with your first draft of the user manual. It was thorough and professionally done. With this in mind, please accept the following criticisms as constructive, and are intended to perfect an already fine document.

The document could have broken down into a few smaller links, rather than a big one; it has taken too much time to load and print. Also, it contains a few spelling mistakes and figures mislabeled. Also, it has some inconsistencies between the screen snapshot and the specific term. We need a document that the users will find a pleasure to read.


Section 1 Introduction

1.1 Overview of System

From the list of information, because there is a certain access right towards each information provided for users, can we refer to each of the information and state the authorized user(s) accordingly?

For detailed instructions on how to perform a search, you suggested users to see section 5 'Performing a Listing Search', but actually it was section 4.

Refer to the figure: Main Search Screen in Buyer Mode, it is unclear about what are the remaining functions that you try to address to, when you said that they are not accessible. Because from what I can see from the screen, there are only three functional buttons in total, i.e. 'Search', 'Clear' and 'Print'.

The topic 'Search by Reference number' has never appeared in anywhere of the document, and there is no section 4.5 found as well.

1.2 Help

The 'Help' button was indicated to be "at the top of the screen", but it has never been found there. In fact, it was located at the bottom of the screens.

Twelve Monkeys Help, one of the four types of help to the users, was not specified clearly of how to get access of it from the system.


Section 2 Security

2.1 Access modes

It would be a good idea to suggest users to refer to section 3 'Accessing/ Exiting program' when necessary. Nevertheless, it has addressed our questions about security of the application appropriately.


Section 3 Accessing/Exiting Program

3.1 Logging On

To be consistent with previous way, when referencing to section(s) in the document, we prefer to have the section number indicated ALWAYS before the topic. i.e. 8.1 'Change Personal Information' and 8.2 'Add/Modify Employee'.

To be more specific, point 3 to log in: Tab to password block, can we restate it to "Press 'tab' key to password block" instead?

3.2 Logging Off

From point 2 and 3, do you mean that the 'Close' option can be selected from the SAME pull-down menu, but there are two different ways to invoke the menu?


Section 4 Performing a Listing Search

4.1 Setting and Changing Search Options

When you classify the search options into five different kinds, since the 'All/Own' option is performed through radio button, and itself a special option for the Realtor and Administrator modes, it can be placed under both of the categories with some explanation given.

The ways to specify a set of search options have been clearly indicated.

4.2 Viewing a Listing

To select another listing to view, there is no "up/down arrow on the scroll bar on the right of the 'Search results' list box" shown from the figures, as indicated in point 2 and 3. More precisely, there exists no vertical scroll bar at all in the list box, but horizontal scroll bar is provided instead.

4.3 Viewing Seller Information

It would be easier to picture the steps of viewing seller information if you referred them to figure 5: Main Search Screen showing Realtor Menu, and figure 6: Add/Modify a Listing, rather than plain text explanation.

4.4 Printing a listing

It is unclear about what the exact output is, when the 'Print' button is pressed.


Section 5 Changing Listings

5.1 Inserting a New Listing

In step 3, when you refer to "the check box 'Add Listing'", we think that it is more appropriate to say "the radio button of 'Add Listing'" instead.

In step 6, you said "Click on 'Browse Picture' ...", there is no such button found on the screen. Do you mean 'Browse' button instead?

In step 7, you said "Click on 'Save' ...", there is no such button found in the 'Add/Modify a Listing' screen. Do you mean 'Save Listing' button in the 'Add/Modify a Listing' screen or some other save buttons in other screen?

5.2 Modifying a Listing

In step 6, you said "Click on 'Save' ...", there is no such button found in the 'Add/Modify a Listing' screen. Do you mean 'Save Listing' button in the 'Add/Modify a Listing' screen, or can it be 'Save Info' button in the 'Seller's Information' screen?

5.3 Deleting a listing

In step 4, you said "Click on 'Delete' ...", there is no such button found in the screen. Do you mean 'Delete Listing' button instead?

5.4 Reassigning a Listing

We are satisfied with the explanation of this section, except there is a spelling error for "Reassign Listing" in your "Administrator pull-down menu".


Section 6 Listing Realtor's Comments

6.1 Viewing the Listing Realtor's Comments

Good. The explanation is clear and easy to understand.

6.2 Adding the Listing Realtor's Comments

Our suppliers say that, quote "These comments can only be accessed by another realtor". We think that the administrator should be able to access this function as well. If this is a typing mistake, please correct it. But if the system is set up this way, we want the supplier to modify it so that the administrator can access this function as well.

6.3 Locating the Listing Realtor

Good. The explanation is clear and easy to understand.


Section 7 Offers on Listings

7.1 Make An Offer

The Field Requirement and Error Handling for 'Ref #' is missing.

7.2 Display Offers

Good. The explanation is clear and easy to understand.


Section 8 Employee Information

Good. The explanation is clear and easy to understand.

8.1 Changing Personal Information

For point number 3, quote "3. Click on the appropriate field to be modify. To change the password...". We think it should be broken down into two points instead of putting everything in one point. "To change the password:..." should come after point 4.

8.2 Add/Modify Employee

Good. The explanation is clear and easy to understand.


Section 9 Limitations

Good. The explanation is clear and easy to understand.


Section 10 Index

Good. The explanation is clear and easy to understand.

End of Document