Mini Assignment 1: Scratches of Rhetoric

Vue.js, the most popular open-source web development framework, is being used widely around the globe to help people to build websites. Meanwhile, its documentation Links to an external site.served a huge amount of people every day to help them learn about and make use of this powerful tool. To guide the developers with clearance and efficiency, it had to be visually well-designed to highlight the key points, while being linguistically accurate, concise and easy-understanding.

Pick the introduction of the documentation to discuss.

The official guide assumes intermediate level knowledge of HTML, CSS, and JavaScript. If you are totally new to frontend development, it might not be the best idea to jump right into a framework as your first step - grasp the basics then come back! Prior experience with other frameworks helps, but is not required. (Evan You et al. 1)

As mentioned in this passage, the audience of the article is assumed to be developers with an intermediate understanding of the techniques and developing experiences, so they will use some proper nouns directly in the subsequent documentation and not explain them. This helped the composers keep the text concise and organized while improving the efficiency of communicating their ideas.

As for text modes, by looking into the following clip, a few characteristics of the document’s particular linguistic and visual modes can be found:

Linguistically, the text maintains a neutral narrative tone, while being as straightforward and concise as possible. At the same time, the composers try to create a relaxed and chat-like and friendly atmosphere within text, by using words like “feel free/if you prefer” and first-person narrative to bring close the audiences.

Visually, the authors intentionally chose different text sizes, fonts, colors, and adjusted the style of some words (bold, hyperlinked, code-styled) to emphasize the different role and importance of different parts of content. Also, there are use of some figure elements (dividing lines, enclosing blocks, exclamation icons, etc.) to guide the visual.

You, Evan. “Introduction - Vue.js.” Introduction — Vue.js, Evan You, 2022, https://v2.vuejs.org/v2/guide/.