apify-docs icon indicating copy to clipboard operation
apify-docs copied to clipboard

style: let the reader decide if something is simple or easy

Open honzajavorek opened this issue 1 year ago • 0 comments

We should refrain from using words like "easy!" or "simply" or "just" or "extremely easy" or "to show you how easy it really is", etc. Let the reader assess how hard a particular step is for them and not stress them out that it should have been easy.

This is something which bothered me quite a lot when reading through the academy for the first time, hence I decided that toning the whole academy down in this regard will be one of my first proposed changes.

This PR is rather large and I'm sorry for that. Most of the changes just remove one word from a sentence, as the sentence works completely the same without it. In some cases it was necessary to rewrite the sentence.

honzajavorek avatar May 22 '24 10:05 honzajavorek