• peopleproblems@lemmy.world
    link
    fedilink
    arrow-up
    12
    ·
    1 年前

    Oh god, oh no.

    Do you realize what that will mean? My coworkers will have to learn how to understand documentation standards that rely on anything but “self documenting code.”

    I am already “an expert (lol @ my salary)” because I read shit they don’t bother looking up. We’re truly doomed.

    • Croquette@sh.itjust.works
      link
      fedilink
      arrow-up
      3
      ·
      edit-2
      1 年前

      That’s a pipe dream thinking all the documentation is complete and well detailed

      I can’t count the times where I read the documentation for the tutorial to get started and the steps described in the official documentation by the official maintainer fails early.

      Documentation is 99% an afterthought (slight exaggeration here)