7 ms·
> a lot of the tutorials available on Digital Ocean are actually good examples of this Second this (although the qualities of DO’s tutorials can vary greatly).
by firexcy 3y ago
> a lot of the tutorials available on Digital Ocean are actually good examples of this
Second this (although the qualities of DO’s tutorials can vary greatly). Indeed, their “Technical Writing Guidelines” [1] agree with the author:
> We avoid words like "simple,” "straightforward,” “easy,” “simply,” “obviously,” and “just,” as these words make assumptions about the reader’s knowledge. While authors use these words to encourage and motivate readers to push through challenging topics, they often have the opposite effect; a reader who hears that something is “easy” may be frustrated when they encounter an issue. Instead, we encourage our readers by providing the explanations they need to be successful.
[1] https://www.digitalocean.com/community/tutorials/digitalocean-s-technical-writing-guidelines#comprehensive-and-written-for-all-experience-levels https://www.digitalocean.com/community/tutorials/digitalocea...