I beg you, if you are a developer of an open source app or program - add screenshots of your app to the README file. When looking for the perfect app, I had to install dozens of them just to see what the user interface looked like and whether it suits me. This will allow users to decide if the app they choose will suit them… Please, don’t think about it, just do it…

  • SpacePirate@lemmy.ml
    link
    fedilink
    arrow-up
    15
    arrow-down
    33
    ·
    1 year ago

    While I get the sentiment, historically, readmes have been text only, and should predominately focus on usage options, not a sales pitch. Today in GitHub, these files support markdown, but the level of effort is probably two orders of magnitude higher than a text readme alone.

    Think of a readme file on GitHub/distributed with the binary more as a man page than a proper website.

        • vsouzas@lemmy.eco.br
          link
          fedilink
          arrow-up
          12
          arrow-down
          2
          ·
          1 year ago

          The best solution is to create an issue and attach the pictures there. You can then link in README and not bloat the repository.

          • andruid@lemmy.ml
            link
            fedilink
            arrow-up
            1
            ·
            1 year ago

            That’s a good point non-text shouldn’t be in the git tree, git-lfs is another solution for that though

    • CoderKat@lemm.ee
      link
      fedilink
      English
      arrow-up
      4
      ·
      1 year ago

      I mean, yes, it’s a little more effort, but I think you’re over playing how much effort is required. Writing a half decent readme is vastly easier than frankly any feature or bug fix. Taking a couple of notable screenshots is super easy. Writing docs is hard (I’ve written tons for large and complicated projects), but readmes are the easiest and including screenshots is really quite easy.

      Everywhere supports markdown in readmes now. Literally everywhere I’ve ever hosted code. And markdown with links to images is perfectly fine even if viewed in plain text mode. They’ll just click the link and view the image standalone. I’ve done that plenty of times, too. Every editor (plus in-browser code hosts in plain text mode) makes it easy.