12 pages of detailed documentation

Home Gamer: Is this it?

Man, what a stupid idea .DS_Store was.

Wow - I applaud the effort but that’s… a lot.

I have frequently used notebooks to sketch out high-level ideas and designs which in itself seems to be a rarity. But at the “It’s detailed enough that someone else could come along and replicate the steps” level is unfathomable to me.

Having to write out what I’m going to do on a physical medium is orders of magnitude slower than typing it out and would just take ages. Maybe it’s just a lack of discipline thing but for me coding is a ton of trial / error / re-write. I refactor code constantly. But it has inspired me to maybe keep more of a log “generally” for things I’ve been working on. It can be useful to be able to refer back to notes rather than needing to dig through emails or git logs hoping to find some rational for a decision…

To create an invite you:

# drop into mongo shell
docker compose exec database mongosh

# create the invite
use revolt
db.invites.insertOne({ _id: "enter_an_invite_code_here" })

That’s pretty jank.

Also - I’m getting pretty fed-up with self-hosting documentation that assumes very specific environments and goes into detailed configuration for that environment. Don’t tell me how to setup a server and how to enable/configure SSH and setup UFW as part of setting up your software. Just tell me how to setup your software and what ports it uses.

That fuck you mean? You can use these drives for any purpose you want.

Sounds like you haven’t taken the time to properly design your environment.

Lots of home gamers just throw stuff together and just “hack things till they work”.

You need to step back and organize your shit. Develop a pattern, automate things, use source control, etc. Don’t just file follow the weirdly -opinionated setup instructions. Make it fit your standard.

What do you mean by “corporate?”

You could look at higher education, non-profits, research, etc.

I don’t want a lot of money

Do you want to work full time? I’d never hire a programmer who wants to work less than 20 hrs/wk and I’d even be very unlikely to hire anyone for less than full time. It’s a pain to coordinate with somebody on a team who isn’t there most of the time.

Maybe small non profits would be interested, but

I’d like to work with REAL programming, not devops, not cloud, not managing containers, I want to write code as a living.

Small businesses will need someone who is flexible and can “do everything”. Typically only large organizations allow people to specialize.

Maybe “bug hunting” or contributing to larger oss projects that have budgets to pay for contributions?

Having to make a decision isn’t my primary issue here (even though it can also be problematic, when you need to serialize domain-specific data for which you’re no expert). My issue is rather in that you have to write this decision down, so that it can be used for deserializing again. This just makes XML serialization code significantly more complex than JSON serialization code. Both in terms of the code becoming harder to understand, but also just lines of code needed.

This is, without a doubt, the stupidest argument against XML I’ve ever heard. Nobody has trouble with using attributes vs. tag bodies. Nobody. There are much more credible complaints to be made about parsing performance, memory overhead, extra size, complexity when using things like namespaces, etc.

I’ve somewhat come to expect less than a handful lines of code for serializing an object from memory into a file. If you do that with XML, it will just slap everything into child nodes, which may be fine, but might also not be.

No - it is fine to just use tag bodies. You don’t need to ever use attributes if you don’t want to. You’ve never actually used XML have you?

https://www.baeldung.com/jackson-xml-serialization-and-deserialization

Yes, which needs to be supported by your parser.

I mean, yeah. But people don’t just do things randomly. Most people put data in the body and metadata in attributes just like html.

They’re siblings. They both derive from SGML. There is a version of HTML that is also XML conformant called XHTML but it never caught on…

JSON is super easy to read and write though. Just needs a parser that allows comments…

Fuck yaml. TOML or literally anything else.

This is your confusion, not an issue with XML.

Attributes tend to be “metadata”. You ever write HTML? It’s not confusing.

The last thing I want to see when I clock out is another terminal screen.

I’m reacting to this mostly. Self-hosters are a bit of an obnoxious blend of people who want turnkey-but-not-Google solutions and people willing to learn how to do things. People whining about “having to use a terminal” are generally in the former category.

Then don’t self host?

…it answers from the attached KBs only. If the fact isn’t there, it tells you - explicitly - instead of winging it.

So you’ve made a FAQ with a LLM interface? I could see that potentially being useful for cooperate “let our bot answer your questions” tools.

But the usefulness of AI isn’t just in “tell me a fact”. Like what would your AI give for "what functions would I use in Python to convert a utf16 string to utf8? Would the answer need to be in the KB already?

You want purity tests for people sharing a things they did? 🙄

Maybe whether they asked any forums for help? Do you want to know who they voted for as well?

I know the solution. Starting this year, students will be forced to contribute to a project they use, care about or, at the very least, truly want to use in the long term. Not one they found randomly on Github.

And they’re still going to find things on GitHub. Because so many things are on GitHub.

They’re blaming the students for the popularity of GitHub. If they want students to not use GitHub then just make that a requirement.

This fella isn’t creating a serious game engine - sounds like they just want to explore the topic, so python would be fine even if it’s incredibly slow.