Thursday, February 11, 2010

Review of Technical Writing

This week in class our weekly blog assignment is to review the piece of technical writing we revised individually in class. I did a short review on Dan Cilen's work which is posted over on his blog.

This assignment was challenging as I have no experience with networking computers, and in this case the subject was antiquated software. After talking to Dan in class I know he had the same misunderstanding that I did with the topic.

After the first read through I did of Dan's revision I felt that it was done well. Even though I have know idea what the instructions are really for I think if I was in the situation where I had to use his instructions I would get the job done. About twenty five percent of the original document was excluded which made for an easy read. The tone throughout the instructions was non bias and generally friendly. Some points of criticism are in step four I would have liked to seen the reference to contacting a network administrator in parenthesise so I know it is not part of the instructions. And in step five it would be simpler to tell readers to check the box instead of "make sure", it would be more to the point.

Fine job Dan, with this simple writing style you would have made many frustrated desk-jockie's jobs easier when trying to establish a shared drives network.

2 comments:

Trevor said...

I also read Dan's revision and thought the same. It was well said and to the point. Instructions have come along ways and readers like it direct. The first example before the revision was very bias and rude. Instructions are suppose to be friendly and informative.

Drew said...

I like how you critiqued this blog. I felt that you clearly had an interest in Dan's subject and that you fairly analyzed his steps. Well done!