Random grammar advice from a tech writer and editor

Random grammar advice from a tech writer and editor

Hi! Tech writer and editor here. My day job is ensuring that blog posts authored by technical folks are clear, easy to follow, and accessible to everyone. I’m feeling feisty today, so here is some unsolicited, nit-picky random grammar and writing advice for you.

  1. Never use an ellipsis. There's a 95% chance you're using it wrong, so just use a period and be done with it.
  2. If you don’t know how to use a semicolon, just use a period and then start a new sentence. In fact, it’s probably a good idea to use a period and start a new sentence, anyway.
  3. Don’t use parentheses if you’re over 40. You’re gonna forget to close them. Actually, don’t use them under 40, either.
  4. Using “and more” at the end of a series instantly turns your post into a marketing piece rather than an educational one. Remove the “and more” and just add a period after the last item.
  5. Ditto with “etc.” It just makes you look like you forgot the rest of the list. The readers can extrapolate if they want.
  6. Keep bulleted or numbered lists to seven items max.
  7. Huge blocks of text are hard to read. Use sub headers to break it up and help guide the reader through your thought process.
  8. Yes, the whole tell-‘em-what-you’re-gonna-tell-‘em, tell-‘em, and tell-‘em-what-you-told-‘em still applies.
  9. Don’t use an em dash when a comma will do, unless you really want to be a drama queen about it.

There is more, but that's enough for now.


Welly Siauw

Principal Partner Solutions Architect - DevOps

2 年

great tips from great bar-raiser!

要查看或添加评论,请登录

?? Heidi Miller的更多文章

  • Why you should join Bluesky and how to use it

    Why you should join Bluesky and how to use it

    This month, it seems that everyone is abandoning Twitter for Bluesky Social. Why, what is it, and how do you use it? I…

    7 条评论
  • Asking ChatGPT to roast me in my cover letter

    Asking ChatGPT to roast me in my cover letter

    If you read my articles, you know I use ChatGPT to draft my cover letters and then add finishing touches myself. Well…

    11 条评论
  • How to apologize for an outage, a lesson for CrowdStrike

    How to apologize for an outage, a lesson for CrowdStrike

    In case you missed it, last Friday, cybersecurity company CrowdStrike recently pushed an update that resulted in mass…

    11 条评论
  • AI-powered job applications: My experience using ChatGPT and Jobscan in my job hunt

    AI-powered job applications: My experience using ChatGPT and Jobscan in my job hunt

    You might have heard that the job market is really tough, and I can certainly testify to that. In fact, it’s doubly…

    8 条评论
  • Is LinkedIn Premium worth it?

    Is LinkedIn Premium worth it?

    A soon-to-be-jobless friend just asked if LinkedIn Premium was worth the cost as a job seeker, and TL;dr my answer was…

    7 条评论
  • Using ChatGPT AI as a résumé collaborator

    Using ChatGPT AI as a résumé collaborator

    As I’ve been experimenting with ChatGPT to tailor my résumé to job descriptions, I’ve been iterating my process. I…

    3 条评论
  • Tailoring my resume using ChatGPT

    Tailoring my resume using ChatGPT

    I am really digging using ChatGPT #AI as my virtual editorial assistant to customize my résumés and cover letters. I…

    1 条评论
  • How I prepare for interviews

    How I prepare for interviews

    This week, I had a few interviews scheduled, so I thought I'd share my interview preparation process. I have a…

    1 条评论
  • Testing job application AI bots

    Testing job application AI bots

    I tried out this job application bot, Massive, which was mentioned in an NPR segment on AI. I was hopeful that it could…

    7 条评论
  • Testing LinkedIn's AI-powered profile assistant

    Testing LinkedIn's AI-powered profile assistant

    Since I’m job hunting, I’m on LinkedIn a bit more than usual, almost every day. I always upgrade to Premium when I’m…

    13 条评论

社区洞察

其他会员也浏览了