Rhetorical Analysis
Five design and writing choices that make up this guide, explaining what they are, who they're for, and how they came to be.
This guide aims to support undergraduate Computer Science students who already know how to code but don't yet integrate AI tools into their development process. Given that this audience reads on phones, laptops, and desktop computers, the rhetorical situation becomes a design problem, and the following five choices each address a piece of it.
Five Rhetorical Choices
01Light and Dark Theme Toggle
By default, the theme toggle located in the top-right corner of the page will toggle the entire site between a dark and light color scheme. Students studying computer science use dark-mode code editors such as VSCode and Cursor, so defaulting to a dark color scheme implies that the guide belongs in their development environment while light mode allows them to view it in bright lecture halls.
02Responsive Mobile Layout
The desktop version of the site consists of a three-column layout, whereas the mobile layout transforms the left navigation rail into a slide-out drawer with a similar structure to the desktop version. Computer Science students often find themselves reading a guide like this mid-discussion and wish to skim the information on their phone prior to viewing it on their laptop, so the chrome itself must change instead of being shrunk down to fit smaller screens.
03Smart Search Functionality
The top navigation includes a search bar that searches through an internal index that categorizes each abstract according to topics such as HumanEval, composer, and cursor rules. The guide does not require a search bar since it only contains six resources, but adding one encourages students to treat this resource as a reference for the rest of the semester rather than a single-use essay.
05Built-In Chatbot
By clicking the chat icon located in the bottom-right corner, the reader gains access to an AI-powered chatbot specifically designed for the content within this guide instead of a generic ChatGPT clone. Since this guide discusses AI-assisted coding, having a chatbot embedded directly within the page would strengthen the argument by allowing the reader to experience prompt-driven retrieval.