Header

Lexoral is open-source so you can punish us

You can read the code for Lexoral, and even use it in your own projects. There's a lot of benefits to being open-source, but there's one that you don't hear people talking about: it lets you punish us for not sticking to our promises.

Originally posted on the Lexoral blog


The intro to this article probably gives you more questions than answers. What does being open-source have to do with punishment? Why would you want to punish us? Why would we encourage that?

In essence, being open-source means that our customers always have another option. It's permanent, and irrevocable. The license could change, but you still have the right to download the code as it is today, and run it yourself without paying us anything.

Making Lexoral open-source gives all of our users that option of last resort - the equivalent of Disney coming out and saying:

We promise to make sure that all our movies are accessible to everyone:
  • If there is no legal way to buy one of our movies, please pirate it.
  • If you can't afford one of our movies, please pirate it.
  • If one of our movies isn't in your language, then pirate it, dub it, and sell it yourself.

That's unimaginable, but if it did happen, I'd certainly trust them more, and I'd trust that our incentives were aligned. I'd trust that their movies would be more accessible, available in all languages, and priced affordably worldwide. Put simply, I'd trust that they cared about their customers over their profit.

That fake quote is very similar to what we promise you. Lexoral is an ethical company, and will earn your trust:

  • If we betray your trust, please steal our software.
  • If we don't provide value for money, please steal our software.
  • If we ignore your feature requests, please steal our software, add them yourself, and start selling it to others.

It's not really stealing, because it's your legal right to do so under our license. Here's how you can use our open-source nature to punish us:

Reading the Code

Our code is hosted on GitHub, and is publicly available here. All our code is on there, updated multiple times a day, even the things we haven't released yet. Even this blog post is open-source: you can see its code and make suggestions here. I try to keep the documentation up-to-date, but if you're confused, feel free to open an issue and ask for help.

Not only can you look through the current state of the code, you can also look at every previous version, or the history for any file. You can see the full list of changes, known as commits, on GitHub. Each one has a timestamp and a description, so you can get a rough idea of what was changed.

I'm not going to try and give a full description of how to use GitHub here, but you get the idea. Everything we do is published for you to explore. Don't trust us? Keep an eye on the commit history, and you'll know exactly what we're up to. Want more information about something? Just get in touch, I'm happy to chat about the reason behind any changes!

Taking the Code

In this section, assume that I have died and been replaced by someone evil. They broke your trust, broke my promises, and it's time for that option of last resort. You want to take our code, and run it yourself. To make punishing us as easy as possible, here are some instructions:

First of all, you'll want to fork Lexoral on GitHub. This gives you a copy of our code that you can edit on your own, independent of our version. The Lexoral repository is set up to deploy to Google Cloud automatically using GitHub Actions and Terraform.

You'll need to set up a Google Cloud Platform account, and create a project on there. Then, replace any mentions of lexoral-prod with the name of your new project. There may be a few other things to change over, but you should be able to get it working with a little bit of effort. You'll also need to work through the list of manual setup steps, because we haven't managed to automate everything yet.

If you get stuck, you can contact me and ask for help. Given that we're assuming I've died, you can also ask a friend who works in DevOps, Cloud, Full-Stack Web, or something like that. It'll be simple for anyone experienced in cloud deployment.

Why would I do this?

Companies make promises all the time, and then they break them with no consequences. For really important things, they'll sign contracts, but that's not much use if the company goes bankrupt or the owner dies. Sometimes they'll have a money-back guarantee, but for all you know that could be a lie too!

Being open-source lets you verify our promises. It lets you see what we're doing behind the scenes, and it lets you punish us when we don't stick to our promises. It means that, no matter how badly we treat you, or how evil my replacement is, you don't have to deal with it. You can leave, and still get value from Lexoral. It might not be as convenient, but it hurts me the most. Our incentives are properly aligned.

I've just written some really detailed instructions about how you can bankrupt Lexoral. I'm not worried about that though. When I claimed we're an ethical company, I meant it: I can't imagine a future in which you'll need those instructions.

There's no better way to show that you can trust us.

Steven Waterman

Steven Waterman

Technical Coach

I've spent my career making development simple. I'm always happy to chat with you - feel free to get in touch!