Replying to 1e4e3714...

nostr:npub1cmgqvz7xr07euwkum3mjghjqcu4d3k2fcyf6g4uwwe5ggnd6fetq0wrzd2 works like "easy", "quick", "trivial" and "simple"should be banned from all documentation and tutorials in general - technical writing is hard, and making technical writing "easy, quick, trivial and simple" is incredibly hard

Claiming any of those verbs in your docs will very likely alienate and frustrate the end-user if they get blocked by *anything* and will significantly reduce the chance of them reaching out to help, because the reader assume they are stupid/missing obvious context

nostr:npub1cmgqvz7xr07euwkum3mjghjqcu4d3k2fcyf6g4uwwe5ggnd6fetq0wrzd2 I spent a significant amount of my time at $DayJob writing, and helping others write docs/1-pagers/RFCs/newsletters - and I try very hard to block these words from any copy we output - for those reasons :)

Reply to this note

Please Login to reply.