Comment on silly costume dance
vithigar@lemmy.ca 2 days agoOne 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.
bearboiblake@pawb.social 1 day ago
Thank you for the feedback. I also explain things in my own words and use the FAQ as a supplementary resource as well as linking to various other sources, depending on the situation. Read it or don’t, your call. I can lead you to water, whether you drink, that’s up to you!
Much love, solidarity forever.