Reflection

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

  1. 01Light and Dark Theme Toggle
  2. 02Responsive Mobile Layout
  3. 03Smart Search Functionality
  4. 04Paired Left and Right Navigation
  5. 05Built-in Chatbot

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.

04Paired Left and Right Navigation

The left navigation rail responds to the question where am I in the guide? while the right navigation rail answers the question where am I on this page? Both rails give the reader a two-axis map, and this feature is critical since every abstract raises the same four questions and the reader wishes to compare answers across resources instead of reading them in sequence.

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.