799
What self hosting feels like (It's painful, please help ๐Ÿฅฒ) (feddit.uk)
submitted 2 years ago by to c/selfhosted@lemmy.world
192 comments fedilink hide all child comments
 
you are viewing a single comment's thread
view the rest of the comments
[โ€“] 84 points 2 years ago (1 child)

This is why Technical Writer is a full time job.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [โ€“] 64 points 2 years ago (4 children)

    It's also why the humanities are important. Stemlords who brag about not doing literature classes write terrible documentation.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 8 child comments
    •
  • [โ€“] 33 points 2 years ago (1 child)

    My CS major required me to take two upper division English classes and I think they helped me more in my career than my upper division CS classes. People forget that documentation is for ourselves too

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [โ€“] 13 points 2 years ago (1 child)

    I'm really thankful that I had a great English teacher in high school, and that my degree required a technical writing class. Being able to write a coherent email got me further in my career than the technical stuff I learned in college.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [โ€“] 13 points 2 years ago (2 children)

    I think this is why the "my code documents itself" attitude appeals, even though it's almost never enough. Most developers just can't write, nor do they want to.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 4 child comments
    •
  • [โ€“] 3 points 2 years ago (1 child)

    Maybe, just maybe, people have different strengths and weaknesses and cooperating around our differences is what makes us succeed.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [โ€“] 15 points 2 years ago (3 children)

    If you know your weakness is writing documentation, please hire a technical writer.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 6 child comments
    •
  • [โ€“] 12 points 2 years ago (1 child)

    That's exactly what I'm saying, sorry if it came across somehow askew.

    My point was there is no point in competing over whose job is "better", we should be working together.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [โ€“] 6 points 2 years ago

    There is a case to be made that people should be a bit more well rounded in general, and not just find a specific niche.

    So non-technical people should still have a decent familiarity with computers and maybe be able to do some very basic coding. And technical people should spend some time working on their written and verbal communication.

    Because in both cases, it makes people more effective in their roles.

  • permalink
  • fedilink
  • source
  • parent
  • [โ€“] 5 points 2 years ago* (1 child)

    Most open source projects rely on volunteers, and few technical writers volunteer.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [โ€“] 2 points 2 years ago (1 child)

    Totally agree. And I'd argue that we don't even need technical writers. Even if all people do is correct grammar and spelling mistakes it would be helpful, let alone actually writing docs. It's one of the easiest ways non-technical folks can get involved with open source projects.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •