cross-posted from: https://lemmy.world/post/21023181

Sharing some lessons I learned from 10 years/millions of users in production. I’ll be in the comments if anyone has any questions!

I hope this series will be useful to the self-hosted and small web crowds—tips for tools to pick and the basics of server management.

  • just_another_person@lemmy.world
    link
    fedilink
    English
    arrow-up
    19
    ·
    2 months ago

    Well, apologies for being bluntly critical. I can offer a few constructive tips to help with writing about technical topics:

    • Try starting with a simple topic flow: topic -> synopsis/purpose of why you’re writing -> background -> observations -> point<>counterpoint loop to elaborate on purpose -> closing
    • Stay away from asserting your point in the title unless you’re showing definitive proof of something
    • Find ways to speak to who may find your writing useful towards the beginning. “If you have a similar problem like X…”, “People who use X may find…”, or “Anyone having similar X experience may find…”. Something like that.