Re:Just Simply – Stop saying how simple things are in our docs
by spondylosaurus on Sunday April 30, 2023 @07:54PM
(#35767655)
What? Adverbs are fine; there's no industry-wide dictum against adverbs.
I think you might be mad at something different than the principles I'm outlining here. These are accepted standards of technical documentation.
Re:Just Simply – Stop saying how simple things are in our docs
by ulizzle on Monday May 01, 2023 @12:56AM
(#35769229)
This is basic English grammar, something you should have learned in grade school.
Re:Just Simply – Stop saying how simple things are in our docs
by spondylosaurus on Monday May 01, 2023 @01:05AM
(#35769280)
Your grade school taught you that adverbs are a form of virtue signaling?
Re:Just Simply – Stop saying how simple things are in our docs
by ulizzle on Monday May 01, 2023 @01:25AM
(#35769379)
No one will fall apart and burst into tears because of an adverb they read in the mountain of documentation we have to read to get the job done.
Navel-gazing of the highest order.
Re:Just Simply – Stop saying how simple things are in our docs
by spondylosaurus on Monday May 01, 2023 @04:18AM
(#35770276)
You lost me there again, my friend. Technical writing stylebooks draw no correlation between adverbs and nervous breakdowns. You seem to be tilting at an entirely different windmill than the one I'm tending to.
Re:Just Simply – Stop saying how simple things are in our docs
by TheCoelacanth on Monday May 01, 2023 @11:34AM
(#35774293)
That's fine, but put your marketing copy in your marketing, not in your docs.
Some frameworks sell simplicity (setup, maintenance) as a feature, so that adverb would be fitting.
But this is just infantilizing and a lot of people (maybe a universal trait) are annoyed by that.