• astrsk@fedia.io
    link
    fedilink
    arrow-up
    17
    ·
    2 months ago

    The older I get, the less time passes between starting a new project and reading the readme / manpages for a library.

    • leisesprecher@feddit.org
      link
      fedilink
      arrow-up
      8
      ·
      2 months ago

      I find it extremely frustrating how weirdly wrong-density much documentation is. It’s extremely detailed in all the wrong places and often lacks examples for common use cases.

      I learned a while ago that news articles are supposed to have increasing levels of detail from top to bottom. Each paragraph adds a bit more context, but the general picture should be contained in the first one. Hardly any documentation follows that pattern.

  • mihor@lemmy.ml
    link
    fedilink
    arrow-up
    4
    ·
    2 months ago

    In the balkans we have a funny term for that - MUP, which stands for Metoda Uzaludnih Pokušaja, the ‘method of futile attempts’.

  • TimeSquirrel@kbin.melroy.org
    link
    fedilink
    arrow-up
    1
    ·
    2 months ago

    “Ah! A configure script! I know how to run these!”

    ./configure && make && make install

    Error: cannot find rare esoteric library not in any of your package repositories and is only found as raw source code on a defunct website on the wayback machine from 2002