The Recommendation Report connects all of the writing projects in this course. It includes several kinds of writing, which we will explore one-by-one. This process will help you assemble the full report over the entire term (rather than trying to write the whole thing all at once).
Length: 15–18 single-spaced pages, including images, appendices, and appropriate formatting. There is not a minimum or maximum page length, but be sure to include all of the required information.
Example Report: See a general recommendation report in Figure 18.8: Sample Recommendation Report, on pages 504–527 of Markel and Selber.
In this report you you will analyze a website and makes recommendations for improving its content and design. Your recommendations will focus on the information on the site, how it is presented (the words and phrases), and what it looks like (the visual display).
Your analysis does NOT include technical aspects of web design and functionality. In other words, do not worry about coding your changes. You do not need any technical knowledge of HTML, CSS, or scripting to complete your analysis.
This project directly relates to our course because technical writing focuses strongly on the best way to phrase ideas, strategies to organize information, and the layout and design that work best for different situations. As you work on analyzing the website you choose, you are practicing skills that you can use to analyze any document that you and your colleagues write in the workplace.
You have a lot of latitude to choose something that interests you, check out the Recommendation Report Website Examples to guide your decision.
As you decide on your topic, keep in mind that you must be able to observe the website fully and gather relevant data to use in your report. You need to test and explore the website thoroughly.
Not only will you need personal observations, you will also need visual and/or audio evidence. You should take photos or record videos that you can use to illustrate your report. I strongly urge you to take screenshots and/or screencasts of the website so that you have details on it even if the site changes or is unavailable.
You should rely on support from books, articles, and webpages that address website design and usability. Resources that discuss writing for online sites will also be useful.
Your report should include a bibliography that provides documentation for all of the resources you have consulted. If you find resources as you are choosing your website, save them and be sure to note the information necessary for bibliographical citations.
You may use the bibliographical format that is appropriate for your field (for instance, and electrical engineer would use IEEE format). Here are some tools you can use to track your sources:
Your report should include details on ethical issues that may impact the website. Use the information in Chapter 2 of Markel and Selber, “Understanding Ethical and Legal Considerations” to identify how ethical concerns impact the site and your potential recommendation. The ethical issues will depend upon the content and focus of the website. Regardless of the focus, you can address the ethical aspects of accessibility of the site and of diverse representation on the site..
Your report must be an original project, written by you, not copied or rephrased from another source. Consider this the requirement not to plagiarize. I have had situations where someone copied and pasted an entire report found online. Don’t do that!
Photo Credit: Website template design on a laptop screen by RawPixel Ltd on Flickr, used under a CC-BY 2.0 license.