this post was submitted on 02 Aug 2024
789 points (96.7% liked)

Selfhosted

40324 readers
661 users here now

A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don't control.

Rules:

  1. Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.

  2. No spam posting.

  3. Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it's not obvious why your post topic revolves around selfhosting, please include details to make it clear.

  4. Don't duplicate the full text of your blog or github here. Just post the link for folks to click.

  5. Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).

  6. No trolling.

Resources:

Any issues on the community? Report it using the report flag.

Questions? DM the mods!

founded 1 year ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 60 points 3 months ago (27 children)

I write technical documentation and training materials as part of my job, and the state of most open source documentation makes me want to stab people with an ice pick.

[–] Anonymouse 15 points 3 months ago (1 children)

You're doing God's work!

Over my career, it's sad to see how the technical communications groups are the first to get cut because "developers should document their own code". No, most can't. Also, the lack of good documentation leads to churn in other areas. It's difficult to measure it, but for those in the know, it's painfully obvious.

[–] [email protected] 6 points 3 months ago (2 children)

Jesus, technical people are some of the worst communicators I've ever worked with.

It's not necessarily their fault though. Y'know who goes into technical jobs? People who often prefer to work with machines, physical stuff, laws of nature, that's who. And often because it's MUCH easier than working with people, at least for them.

On top of that, soft skills are HARD. Communication is HARD. It comes easier for some, but it's a skill like any other. It's the technical socialites, the diplomatic devs who become the best managers and leaders, due to the rarity of their hybrid skillsets.

I'm in the middle. Just technical enough to mostly understand the devs and understand the implications of plans, and just enough soft skills to turn that into decent documentation, emails, and working with clients.

SUCKS that I've gotten a taste of project management and hated the absolute fuck out of it. I probably would've been decent at it otherwise.

[–] Entropywins 6 points 3 months ago

"Well--well look. I already told you: I deal with the god damn customers so the engineers don't have to. I have people skills; I am good at dealing with people. Can't you understand that? What the hell is wrong with you people?"

[–] [email protected] 3 points 3 months ago

SUCKS that I’ve gotten a taste of project management and hated the absolute fuck out of it. I probably would’ve been decent at it otherwise.

Good PMs are rare, and precious. You could maybe give it another ..

emails

oh, nevermind. :-P

load more comments (25 replies)