I’ve been transitioning to Linux recently and have been forced to use github a lot when I hadn’t much before. Here is my assessment.

Every github project is named something like dbutils, Jason’s cool photo picker, or jibbly, and was forked from an abandoned project called EHT-sh (acronym meaning unknown) originally made by frederick lumberg, forked and owned by boops_snoops and actively maintained by Xxweeb-lord69xX.

There are either 3 lines of documentation and no releases page, or a 15 page long readme with weekly releases for the last 15 years and nothing in between. It is either for linux, windows, or both. If it’s for windows, they will not specify what platforms it runs on. If it’s for Linux, there’s a 50% chance there are no releases and 2 lines of commands showing how to build it (which doesn’t work on your distro), but don’t worry because your distro has it prepackaged 1 version out of date and it magically appears on flatpak only after you’ve installed it by other means. Everything is written in python2. It is illegal to release anything for Mac OS on github.

  • BlackLaZoR@fedia.io
    link
    fedilink
    arrow-up
    4
    ·
    7 months ago

    Wait until you install some package and then scratch your head not knowing how to run it.

    • SanicHegehog@lemm.ee
      link
      fedilink
      arrow-up
      2
      ·
      7 months ago

      Then think “I’ll figure it out later” but you never do. Only to be reminded of it a month later when you happen to see it scroll by in an apt-or-whatever package upgrade.

      “Oh yeah, I forgot about that. I should check that thing out again” you think to yourself. But you never do. Repeat for eternity.

    • Darohan@lemmy.zip
      link
      fedilink
      arrow-up
      1
      ·
      7 months ago

      Helix Editor did this to me. They have so much documentation on their site about how to use the editor, how to extend it, theme it, etc., etc. What they didn’t seem to document, though, is that the binary is named hx, not helix :/

  • Petter1@lemm.ee
    link
    fedilink
    arrow-up
    1
    ·
    7 months ago

    If your distro was arch, you most likely have the nightly build available on the AUR

    • Alk@lemmy.worldOP
      link
      fedilink
      English
      arrow-up
      1
      ·
      7 months ago

      Yes the world of github and linux is vast and I am like a newborn baby. I hope to visit your bubble one day my friend.

  • november@lemmy.vg
    link
    fedilink
    English
    arrow-up
    1
    ·
    7 months ago

    your distro has it prepackaged 1 version out of date

    And the only reason you wanted to install the thing is because it’s a prerequisite for some other thing you wanted to install, which requires the latest version.

  • Vash63@lemmy.world
    link
    fedilink
    arrow-up
    1
    ·
    7 months ago

    As someone who works fairly extensively with all three major platforms… You’re definitely wrong about macOS here. Almost everything on GitHub that works on Linux also works on Mac, aside from GUI applications which are often more OS dependent. The readme pages often just lump Mac and Linux together as they can be pretty similar, especially for things written for interpreted languages (python) where it’s often literally the same.

    • Violet_McQuasional@feddit.uk
      link
      fedilink
      arrow-up
      0
      ·
      7 months ago

      I recently bought a MacBook Air M1 and I came at it from a classic “ThinkPad with Fedora on it” Linux nerd perspective. I got given a Mac at work a couple of years ago, and I warmed to it. I agree that Macs are great tools for DevOps work. I used to think they were just for posers but I’ve been converted.

  • Grenfur@lemmy.one
    link
    fedilink
    arrow-up
    1
    ·
    7 months ago

    When I first moved to linux I felt this same way. It gets better. Now days I fucking love those 15 page ReadMes and I’m not bothered if there’s no steps for my distro. The sheer volume of documentation surrounding linux packages is insane. There’s often a ton of ways to configure and manage the to fit your needs. That freedom is what I love so much about linux.

    As for the ones with 2 lines, I don’t think I’ve seen that as much. I generally would avoid them unless the source was clear what the project did.

    At any rate there will come a day when it starts to click. It’s just a marathon not a sprint.

  • Guenther_Amanita 🍄@slrpnk.net
    link
    fedilink
    arrow-up
    0
    ·
    edit-2
    7 months ago

    Just a small (or maybe big?) tip for you 🙂

    If it’s for Linux, there’s a 50% chance there are no releases and 2 lines of commands showing how to build it (which doesn’t work on your distro), but don’t worry because your distro has it prepackaged 1 version out of date

    There’s a tool called Distrobox.
    You can install it (via CLI I think?), and then manage it the easiest graphically way via BoxBuddy (available in your Software Center), or just the terminal if you prefer it.

    With it, you can screw all those “Doesn’t work on my distro” moments.

    You’re on Linux Mint? No problems, here’s the AUR for you!

    ✨✨✨ BONUS: Your OS won’t break anymore randomly due to some AUR incompatibility, because everything is containerized! ✨✨✨

    Even if you run Arch, use it to install AUR stuff. Or Debian/ Ubuntu, add PPAs only via Distrobox.

    It’s absolutely no virtual machine. It basically only creates a small, lightweight container with all dependencies, but it runs on your host. Similar to Flatpaks.

    You can also export the software, and then it’s just like you would have installed it natively!
    Your distro choice doesn’t matter anymore. You now can run any software written only for Suse, an abandoned Debian version 10 years ago, Arch, Fedora, Void, whatever. It’s all the same.

    I hope that was helpful :)

    • superweeniehutjrs@lemmy.world
      link
      fedilink
      arrow-up
      0
      ·
      7 months ago

      That’s great, but it should still be possible and well documented for people to run things natively. Some people want less bloat for technical reasons (maintaining a product with very little storage or memory). Tinycore Linux is my go-to example of the benefit of keeping things lightweight for a purpose.

      • skilltheamps@feddit.org
        link
        fedilink
        arrow-up
        0
        ·
        7 months ago

        When you’re maintaining a product that is based on linux, you’re surely qualified to port that thing to your platform yourself.

        Open source developers are thanklessly giving away their work for free already, and for the many things where there’s just a github page it is just a one man show run in spare time. Don’t demand them to give away even more of their time to cater for whatever distro you’re using, just because you are not willing to invest the time to learn how linux works and also not willing to give a way a few megabytes for the dependencies they’re developing against.

        All the discussions about things like distrobox and flatpak where linux novices express their dissatisfaction due to increased disk space are laughable. In the linux universe sole users have no power in deciding what goes, they do not pay anything and at worst pollute the bug tracker. Developers are what make up the linux universe, and what appeals to them is what is going to happen. Flatpak is a much more pleasant experience to develop for than a gazillion distros, hence this is where it is going, end of story. As a user either be happy with wherever the linux rollercoaster goes, or - if you want to see change- step up and contribute.

          • Richard@lemmy.world
            link
            fedilink
            English
            arrow-up
            0
            ·
            7 months ago

            Next time, try to engage rationally and in good faith with the commenter you are responding to :)

            • IsThisAnAI@lemmy.world
              link
              fedilink
              arrow-up
              0
              ·
              edit-2
              7 months ago

              I did. Linux zealots can’t handle the truth about regular users and they mostly do not and will not accommodate them. This conversation has been going on 40 years now.

  • superkret@feddit.org
    link
    fedilink
    arrow-up
    0
    ·
    7 months ago

    Be the change you want to see in the world.

    I’m currently in the process of updating Slackware’s documentation, some of which hasn’t been touched in 12 years.
    It’s completely out of date, so no one uses it anymore.
    And because no one uses it, no one updates it.

    • ArcaneSlime@lemmy.dbzer0.com
      link
      fedilink
      arrow-up
      0
      ·
      7 months ago

      You’re doing “Bob’s” work son, thank you for your service!

      As a devout SubGenius myself it is my destiny to use Slackware one day but alas I fear it is currently above my skill level, more documentation will help people like me greatly! PRABOB!

      1000003261

      • superkret@feddit.org
        link
        fedilink
        arrow-up
        0
        ·
        7 months ago

        It’s easier to install and administer than Arch, and won’t break on updates.
        But yeah, the current state of the documentation is discouraging.

        • ArcaneSlime@lemmy.dbzer0.com
          link
          fedilink
          arrow-up
          0
          ·
          7 months ago

          I’m more worried about package management I guess. Though I suppose now with flatpak that may be less of an issue. Still I use some weird shit, some of it is only packaged as a .deb or .rpm on their site, like the Brother printer drivers.

          And yeah the documentation lol. I rely heavily on that or places like lemmy for linux help, which is why to start I picked a really popular distro with good documentation (fedora). It’s definitely something I’ll try one day though!

          • superkret@feddit.org
            link
            fedilink
            arrow-up
            1
            ·
            edit-2
            7 months ago

            You can have a look at slackbuilds.org to see if what you need is available. It’s Slackware’s AUR equivalent.
            You can install packages from there using sbopkg, which does handle dependencies.

            It does have the Brother drivers: https://slackbuilds.org/repository/15.0/system/brlaser/

            Up-to-date documentation comes in the form of easy to understand text files written by Pat himself, that are installed with the distro. For questions, linuxquestions.org is the place to go. The main devs of the distro read and post there regularly.
            That’s also what I love about Slackware. I wrote one of the main devs an e-mail and got a helpful, friendly reply half an hour later. That’s what Linux used to be like.