• 0 Posts
  • 196 Comments
Joined 1 year ago
cake
Cake day: July 7th, 2023

help-circle






  • I think you might be seriously underestimating how big a deal wrestling still is in America. We’re not in the glory days of the eighties anymore but it’s still capable of catapulting people like John Cena to mega stardom. Cody Rhodes has barely been back in WWE for a year, and he’s already been added to Call of Duty: Warzone. AEW is the baby brother to WWE and they’re now regularly selling out Wembley Stadium. None of that is small time.




  • Very different to the games that came after it, and probably the actual inspiration for SAO in the show. The whole thing about players speccing into crafting or whatever and then setting up their own shop was a really big thing on UO servers. Players would literally build entire towns together, and then fill them with shops that they would run. There was a huge part of the player base that were basically civilians, kind of like Arma modern life roleplay servers.

    Also, for the record… It’s still running, somehow.








  • I’ll see about digging up recommendations if I can, but I’m on my phone right now.

    My biggest single piece of advice would be this: Understand that your reader does not share your context.

    What this means is that you have to question your assumptions. Ask yourself, is this something everyone knows, or something only I know? Is this something that’s an accepted standard, or is it simply my personal default? If it is an accepted standard, how widely can I assume that accepted standard is known?

    A really common example of this in self-hosting is poorly documented Docker instructions. A lot of projects suffer from either a lack of instructions for Docker deployment, because they assume that anyone deploying the project has spent 200 hours learning the specifics of chroot and namespaces and can build their own OCI runtime from scratch, or needlessly precise Docker instructions built around one hyper-specific deployment method that completely break when you try to use them in a slightly different context.

    A particularly important element of this is explaining the choices you’re making as you make them. For example a lot of self-hosted projects will include a compose file, but will refuse to in any way discuss what elements are required, and what elements are customisable. Someone who knows enough about Docker, and has lots of other detailed knowledge about the Linux file system, networking, etc, can generally puzzle it out for themselves, but most people aren’t going to be coming in with that kind of knowledge. The problem is that programmers do have that knowledge, and as the Xkcd comic says, even when they try to compensate for it they still vastly overestimate how much everyone else knows.

    OK, I said I’d try for examples later, but while writing this one did come to mind. Haugene’s transmission-openvpn container implementation has absolutely incredible documentation. Like, this is top tier, absolutely how to do it; https://haugene.github.io/docker-transmission-openvpn/

    Starts off with a section that every doc should include; what this does and how it does it. Then goes into specific steps, with, wonder of wonders, notes on what assumptions they’ve made and what things you might want to change. And then, most importantly, detailed instructions on every single configuration option, what it does, and how to set it correctly, including a written example for every single option. Absolutely beautiful. Making docs like this is more work, for sure, but it makes your project - even something like this that’s just implementing other people’s apps in a container - a thousand times more usable.

    (I’ve focused on docker in all my examples here, but all of this applies to non-containerized apps too)




  • It’s not so much that Dockge shows more, and more that it does more. Log viewing in Dockge is actually pretty bad; it’s honestly the one thing that really needs more work. But Dockge is a full management plane; it allows you to deploy, modify, bring up and bring down entire compose stacks. Dozzle is only a log viewer, nothing else. Given that log viewing is the one thing Dockge does badly, they’re actually a perfect complement to each other, and I’d strongly recommend running both.