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
    link
    fedilink
    10021 days ago

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

    • @[email protected]
      link
      fedilink
      4421 days 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.

    • @[email protected]
      link
      fedilink
      3621 days 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 :/

      • Ephera
        link
        fedilink
        820 days ago

        The fun part is that as a dev, you don’t really know that either. It’s just the file name of the executable. Anyone can rename that.
        And even if it’s not renamed, you still don’t know, if your users need to call it with just hx or with ./hx or some other path.

        Obviously, you should mention somewhere that the executable is likely called hx, but because that requires an explanation, there’s certainly a tendency to not mention it very often…

        • @[email protected]
          link
          fedilink
          720 days ago

          Congrats on expressing that in the most passive-agressive and gatekeepery way you could’ve. I’ve been using Linux for the better part of a decade now, and know my way around the usr dir - however things work a bit different on NixOS, whose package manager doesn’t involve installation steps beyond adding the word “helix” to my packages list. I’m not great at reading though, so I absolutely would’ve missed something as obvious as the Installation page 😅 As for your beliefs about postmodern Vim clones, what’s the point (and fun) in the freedom of choice Linux offers if I can’t install and try out the latest fun spin on an old fave from time to time?

      • @[email protected]
        link
        fedilink
        520 days ago

        I think they meant you don’t know what the binary is called because it doesn’t match the package name. I usually list the package files to see what it put in /use/bin in such cases.

    • NostraDavid
      link
      fedilink
      -220 days ago

      If I install a package, I don’t even know what it installed and/or where.

      I can’t believe Linux can’t even tell you what it installed where - even Windows can do that.

    • @AlkOP
      link
      English
      5221 days 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.

      • ???
        link
        520 days ago

        My bubble is mostly lm, which comes in two flavors:

        (1) useless repo made up entirely of jupyter notebooks and 28363 requirements achieved via pip freeze

        (2) simple, friendly, well documented, runs

  • @[email protected]
    link
    fedilink
    47
    edit-2
    21 days 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
      link
      1321 days 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.

      • @[email protected]
        link
        fedilink
        921 days 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.

        • @IsThisAnAI
          link
          0
          edit-2
          20 days ago

          Why Linux will never be mainstream ^

          No… It’s the users that are wrong and stupid.

          • @ricdeh
            link
            English
            420 days ago

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

            • @IsThisAnAI
              link
              0
              edit-2
              20 days 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.

              • TimeSquirrel
                link
                fedilink
                520 days ago

                Did you forget the part where everybody is getting it for free and devs aren’t getting paid to do this shit? If you want your hand held, use Windows or MacOS.

      • @[email protected]
        link
        fedilink
        520 days ago

        Each to their own. Linux is, in my opinion, about choice. If one prefers everything to be ultra minimalist, native and lightweight, then that’s fine.

        I personally just find to be Linux’ most overlooked strength is containerization. It’s one of the main reasons why most servers run Linux, because of things like Docker. On the desktop, containers are way underutilized, but that’s now slowly changing with things like Flatpak or Distrobox.

        A distrobox container is technically more bloated than a native install, sure, that’s correct.

        But, in my opinion, it’s like saying “Drawers and closets are bloat for my apartment. I throw everything on the floor.” Yeah, now you have less things in your room, but it looks like shit, you can’t find anything and you fall over your tubberware that’s mixed with your underwear and shampoo.

        Having everything collected in a container only costs me a few hundred MBs and a small amount of RAM if needed. But, literally every PC has more than 50 GB hard drive space and 8 GB RAM. If your system slows down because of one container, then your PC is the problem, not distrobox.

        That absolutely doesn’t mean we should stop optimizing software of efficiency. But it can help us to spend our time on more important stuff, like fixing bugs or adding new cool features.

        I really love Flatpak because of that. Sure, it has some drawbacks, but as soon as more devs support Flatpak officially, and iron out some issues we currently have, like misconfigured permissions, they’re (imo) the best package format. Why should a distro maintainer have to apply every software change to their package format? That’s needlessly duplicated work.

    • @AlkOP
      link
      English
      220 days ago

      Oh cool, I’ll have to check it out! Thanks!

  • @[email protected]
    link
    fedilink
    English
    3021 days 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.

    • @saltesc
      link
      521 days ago

      God, I hate that.

      Then you do a clean up day and start removing shit you don’t know what is or even use. Then a few weeks later something doesn’t work and you don’t know why, but it was probably something you removed, so you go through the entire git journey again, throwing and taking the exact same punches to get things running.

  • @[email protected]
    link
    fedilink
    2920 days 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.

    • @[email protected]
      link
      fedilink
      1420 days 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

      • @[email protected]
        link
        fedilink
        520 days 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.

        • @[email protected]
          link
          fedilink
          120 days 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!

          • @[email protected]
            link
            fedilink
            4
            edit-2
            20 days 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.

    • @Tangent5280
      link
      218 days ago

      Look at the brightside: there’s no risk of an update resetting your progress

    • @[email protected]
      link
      fedilink
      2520 days ago

      Aur and pacman are 90% of why I use arch.

      Also fyi to OP: never install software system-wide without your package manager. No sudo make install, no curl .. | sudo bash or whatever the readme calls for. Not because it’s unsafe, but because eventually you’re likely to end up with a broken system, and then you’ll blame your distro for it, or just Linux in general.

      My desktop install is about a decade old now, and never broke because I only ever use the package manager.

      Of course in your home folder anything goes.

      • @[email protected]
        link
        fedilink
        620 days ago

        Also fyi to OP: never install software system-wide without your package manager. No sudo make install, no curl .. | sudo bash or whatever the readme calls for.

        And that is why Linux isn’t ready for mass adoption.

        I had to fuck around for hours to make my wifi adapter work and everyone was referencing this one project on GitHub and the way to install it and what actually worked was to sudo make install.

        You’re the first person I see that’s saying not to do that, I had to use instructions from the Linux Mint forum to try and get it installed the first time and no one mentioned that, I found alternative projects but none of them had clear instructions “You must have installed X, Y, Z first” without any explanation how to do it.

        So, for new users, Linux is all about blind trust in strangers to make stuff work and if you have no interest in learning programming that’s what your experience will continue to be.

        • @acchariya
          link
          120 days ago

          Parsing poorly documented c spaghetti code is not a good vehicle to learn programming anyway though. The root issue here is the fact that interop between open source software and other oss, closed source software, and firmware is a headless beast where each user has to take on the project manager role.

        • @[email protected]
          link
          fedilink
          120 days ago

          I guess you had to install lwfinger’s rtw88 backport? If true, then the problem was the outdated kernel used in mint (I guess 1.15.y at the time) should work now out of box with the new kernel update ubuntu (and therefore mint as downstream as well) released some months ago.

          I think, it is 6.2.y now and in 6.2 rtw88 got a massive update.

      • @AnUnusualRelic
        link
        4
        edit-2
        20 days ago

        Absolutely. Funky installs go in ~/bin. (Ok, plus the valve directory)

        Everything else comes from standard repositories.

      • @[email protected]
        link
        fedilink
        420 days ago

        never install software system-wide without your package manager.

        What’s the alternative of sudo make install and curl | sudo bash if a package is not available in AUR? I am unfamiliar with make install .

        • @[email protected]
          link
          fedilink
          3
          edit-2
          19 days ago

          Well personally if a package is not on aur I first check if there’s an appimage available, or if there’s a flatpak. If neither exist, I generally make a package for myself.

          It sounds intimidating, but for most software the package description is just gonna be a single file of maybe 10-15 lines. It’s a useful skill to learn and there’s lots of tutorials explaining how to get into it, as well as the arch wiki serving as documentation. Not to mention, every aur or arch package can be looked at as an example, just click the “view PKGBUILD” link on the side on the package view. You can even simply download an existing package with git clone and just change some bits.

          Alternatively you can just make it locally and use it like that, i.e. just run make without install.

      • @[email protected]
        link
        fedilink
        320 days ago

        😁I prefer yay to search and install stuff from AUR using a single command 🥰 and if you choose the endeavour flavour of arch, then you have yay preinstalled 😋👌🏻

      • @[email protected]
        link
        fedilink
        2
        edit-2
        20 days ago

        How the fuck do you have a decade old arch installation? I have to reinstall it about every half a year because something breaks and its to complicated to fix it so I just choose to reinstall everything. In the 18 Months or so that I used Arch I had to reinstall it about 4 times. I don’t even install that much stuff and I also don’t go absolutely wild with configuration, but Theres A lot of stuff breaking in my system.

        I also got used to just ignoring problems because I’m to lazy to reinstall everything or spend hours upon hours fixing my system.

        • Blaster M
          link
          English
          120 days ago

          Everyone on Lemmy: “Just use Arch! Why are you using anything but Arch! Arch is the best! Arch is better than everything else!”

          Also Lemmy users: ∆

          Me: So my Ubuntu Server, which has been the same install for well over 10 years, hasn’t needed a reinstall ever… even through corrupted RAM, multiple hardware changes, and drive upgrades, I’ve just cloned it and kept on trucking…

          …and yet everyone says Ubuntu is the worst…

          • @[email protected]
            link
            fedilink
            120 days ago

            Arch is great. I absolutely love it and the AUR. The only problem is, that it seems to produce a shit load of Errors for me.

    • Pumpkin Escobar
      link
      English
      520 days ago

      Really love arch and the AUR. I’ve been tempted to get nix set up for the rare cases when there’s no AUR package or the AUR package is unmaintained. I figure if there’s no package in the AUR or nixpkgs, it’s probably not worth running.

      • @[email protected]
        link
        fedilink
        520 days ago

        I yet hope to find a unmaintained arch package to have a reason to write my own PKGBUILD file😁

  • @[email protected]
    link
    fedilink
    2721 days 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.

    • ???
      link
      320 days ago

      Learning to read docs is basically learning how to learn. If good docs exist and you have the skill of reading them, your life will get significantly easier.

  • @[email protected]
    link
    fedilink
    English
    2220 days ago

    Yeah. Pretty much.

    The worst part about free Linux programs is that they have 0 visibility or marketing.

    Almost everything I know of is from other people whom are far more passionate about keeping track of the foss landscape.

    Sorry, guys I don’t check AUR every night before bedtime.

  • @Vash63
    link
    2120 days 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.

    • @[email protected]
      link
      fedilink
      620 days 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.

        • @[email protected]
          link
          fedilink
          1
          edit-2
          19 days ago

          I home brew installed most stuff, yeah. I’m lucky in that I don’t need a whole lot of stuff installed. Just a couple of JetBrains IDE’s, a couple of browsers, iTerm2 and a handful of popular CLI utilities.

          • @[email protected]
            link
            fedilink
            119 days ago

            I really miss a consistent package manager on Windows when I have to use it for work. The website download and install method just grinds on me. I guess some of this is still prevalent on Mac and for CLI stuff I guess home-brew comes in.

            Do you miss any customizability?

      • @Vash63
        link
        320 days ago

        Yep. I’m Linux at home but macOS all day at work. My employer won’t let us use Linux workstations (despite everything I work on being Linux…). Both are vastly superior to Windows.

        • @[email protected]
          link
          fedilink
          English
          118 days ago

          My employer is the same and it drives me crazy. wInDoWs iS mOrE sEcUrE! Yet literally all of our software runs in Linux environments. We even tell people to build in Windows but target Linux. I had a M2 Max at one point because I finally convinced them to at least let me have that and was forced back to Windows because our stupid MDM software only really works properly on Windows. :(

    • @thebestaquaman
      link
      119 days ago

      Came here to say this. Just get home brew up and running. One you have gcc and your other basic tools installed, there’s very few Linux guides that won’t work on a Mac. A couple shell tools have different names, but that’s about it.

      • @[email protected]
        link
        fedilink
        218 days ago

        Between homebrew and nix, the amount of foss macs can run out of the box is pretty close to some generic Ubuntu (nixpkgs is technically the largest repo out there, but not all of the nixpkgs are available on mac).

        • @thebestaquaman
          link
          117 days ago

          And that’s just regarding stuff that’s distributed pre-built with a package manager. Truth is, if you’re down to build stuff from source, you can just follow the Linux guide and everything will work right out of the box far more often than not.

  • Eager Eagle
    link
    English
    2021 days ago

    wait, does apple let users access github?

      • @Deckweiss
        link
        14
        edit-2
        21 days ago

        Well, they have blocked a mobile phones connection when you held it in your hand sooooo

        “You’re browsing it wrong”

        /s

            • @[email protected]
              link
              fedilink
              6
              edit-2
              20 days ago

              Iphone 4 had a shitty antenna design. This was the first iphone with a metal frame around, on the sides of the phone. If you holded it with your left hand you could easily accidentally short the two parts of the antenna, basically cutting all signals.

              This was definetily a design fault, there was even class action lawsuit against Apple. When they asked Steve Jobs about this, he replied:

              “You are holding it wrong.”

      • qaz
        link
        English
        821 days ago

        It’s a joke

  • @hperrin
    link
    2021 days ago

    I release a lot of my software in GitHub and I’m offended at how accurate this is.

  • @[email protected]
    link
    fedilink
    1920 days ago

    GitHub is a place you can use to easily put a copy of your code online. Many people just want to build a working solution and move on. Building a useful GitHub project, with fancy stuff like releases, is work that isn’t really solving any issues. Many people don’t like doing it. Many people especially don’t want to invest time in proprietary solutions like GitHub. They might not even accept pull requests on GitHub.

    Quality assessment though 😄