Comment on silly costume dance

<- View Parent
vithigar@lemmy.ca ⁨2⁩ ⁨days⁩ ago

One of the most important aspects of writing is to choose an appropriate style and language for your intended audience. The purpose of an FAQ is typically to address common questions from laypersons, but this is not written in a way that a layperson is inclined to consume.

It’s dense while also being aggressively loquacious. A.1.1 spends over 200 words before it even starts to meaningfully answer the question. Then, after answering the question in about a half a dozen words, continues with a philosophical essay about what hierarchy means. Yes, some questions are nuanced and may need elaboration, but this document goes far beyond elaboration into rambling.

Who is this FAQ for?

On top of this there is a complete lack of page formatting, making it not only stylistically difficult to read, but also tiring as you track lines the entire width of your screen.

If you want to win people over, give them something they might want to read, not something that’s going to discourage them literally the instant they see the page before a single word is even processed.

source
Sort:hotnewtop