Skip to main content

17 posts tagged with "Educates"

Educates Training Platform

View All Tags

Reviewing workshops with AI

· 7 min read
Graham Dumpleton
Lead Software Engineer

In our previous post we walked through deploying an AI-generated Educates workshop on a local Kubernetes cluster. The workshop was up and running, accessible through the training portal, and ready to be used. But having a workshop that runs is only the first step. The next question is whether it's actually any good.

Workshop review is traditionally a manual process. You open the workshop in a browser, click through each page, read the instructions, run the commands, check that everything works, and make notes on what could be improved. It's time-consuming and somewhat tedious, especially when you're the person who wrote the workshop in the first place and already know what it's supposed to do. Even this task, though, is one where AI can help.

Deploying Educates yourself

· 6 min read
Graham Dumpleton
Lead Software Engineer

In our last post we showed how an AI skill can generate a complete interactive workshop for the Educates training platform. The result was a working workshop for the Air Python web framework, and you can browse the source in the GitHub repository. But having workshop source files sitting in a repository is only half the story. The question that naturally follows is: how do you actually deploy it?

If you've used platforms like Killercoda, Instruqt, or Strigo, the answer would be straightforward. You push your content to the platform, and it handles the rest. But that convenience comes with a trade-off that's easy to overlook until it bites you.

Teaching an AI about Educates

· 14 min read
Graham Dumpleton
Lead Software Engineer

The way we direct AI coding agents has changed significantly over the past couple of years. Early on, the interaction was purely conversational. You'd open a chat, explain what you wanted, provide whatever context seemed relevant, and hope the model could work with it. If it got something wrong or went down the wrong path, you'd correct it and try again. It worked, but it was ad hoc. Every session started from scratch. Every conversation required re-establishing context.

What's happened since then is a steady progression toward giving agents more structured, persistent knowledge to work with. Each step in that progression has made agents meaningfully more capable, to the point where they can now handle tasks that would have been unrealistic even a year ago. We've been putting these capabilities to work on a specific challenge: getting an AI to author interactive workshops for the Educates training platform. In our previous posts we talked about why workshop content is actually a good fit for AI generation. Here we want to explain how we've been making that work in practice.

Maintaining a Fixed IP for Educates Local Clusters on macOS

· 9 min read
Jorge Morales Pou
Lead Software Engineer

When running Educates locally on macOS, your cluster's accessibility depends on your machine's IP address. Every time you move between networks — home, office, conference WiFi — your IP changes. DNS resolution breaks, cluster ingresses stop responding, and workshop URLs go stale. This can be a hassle — especially when you don't immediately realize the IP changed and spend time debugging something else entirely. You end up manually updating the resolver configuration before you can get back to work.

In the How to best work locally post, we showed how to configure a local DNS resolver with a recognizable domain like educates.test. And in Automating DNS Resolver Updates, we covered how to detect IP changes and re-sync the resolver automatically. Both of those approaches react to the IP change after it happens. The approach in this post eliminates the change altogether. A better approach is to prevent the problem entirely: give your machine a fixed IP that never changes, regardless of which physical network you're on.

Clickable actions in workshops

· 8 min read
Graham Dumpleton
Lead Software Engineer

The idea of guided instruction in tutorials isn't new. Most online tutorials these days provide a click-to-copy icon next to commands and code snippets. It's a useful convenience. You see the command you need to run, you click the icon, and it lands in your clipboard ready to paste. Better than selecting text by hand and hoping you got the right boundaries.

But this convenience only goes so far. The instructions still assume you have a suitable environment set up on your own machine. The commands might reference tools you haven't installed, paths that don't exist in your setup, or configuration that differs from what the tutorial expects. The copy button solves the mechanics of getting text into your clipboard, but the real friction is in the gap between the tutorial and your environment. You end up spending more time troubleshooting your local setup than actually learning the thing the tutorial was supposed to teach you.

When AI content isn't slop

· 7 min read
Graham Dumpleton
Lead Software Engineer

In a post on my personal site I talked about the forces reshaping developer advocacy. One theme that kept coming up was content saturation. AI has made it trivially easy to produce content, and the result is a flood of generic, shallow material that exists to fill space rather than help anyone. People have started calling this "AI slop," and the term captures something real. Recycled tutorials, SEO-bait blog posts, content that says nothing you couldn't get by asking a chatbot directly. There's a lot of it, and it's getting worse.

The backlash against AI slop is entirely justified. But I've been wondering whether it has started to go too far.

Automating DNS Resolver Updates for Dynamic IP Addresses on macOS

· 4 min read
Jorge Morales Pou
Lead Software Engineer

When developing with Educates on a local machine, many developers rely on the local DNS resolver functionality to provide their Educates cluster with a meaningful hostname. A common approach is to use a domain like educates.test for consistent local cluster access.

However, laptop users frequently encounter network transitions—moving between office, home, conference, or other network environments. These transitions result in IP address changes that break DNS resolution for the configured hostname. When this occurs, the cluster becomes inaccessible via the expected domain name, requiring manual DNS resolver updates.

This issue can be particularly frustrating when the DNS resolver is running in the background, as the root cause may not be immediately apparent. To address this challenge, I developed an automated solution that monitors IP address changes and updates the DNS resolver configuration accordingly.

Announcing Educates Hub

· 2 min read
Jorge Morales Pou
Lead Software Engineer

We are excited to announce the launch of Educates Hub, the official resource aggregator for the Educates community! You can explore it today at https://hub.educates.dev.

Educates Hub is your new central destination for discovering, sharing, and managing resources for your workshops. Our goal is to create a vibrant ecosystem where the community can easily access high-quality content and tools to make the most out of Educates.

Terraform deployment quickstart

· 10 min read
Bill Kable
Engineer

Hi all, we are happy to announce we are now sharing the Educates Terraform Modules project that provides support for deploying Educates on Amazon and Google Cloud providers.

Its release versions are independent from the Educates Training Platform releases; however, it is currently tested and verified to work on Educates 3.2.x and 3.3.x on Kubernetes version 1.32.

We've provided the quick start here so you can experiment with it and give feedback.

Managing educates versions with educatesenv

· 3 min read
Jorge Morales Pou
Lead Software Engineer

Managing multiple versions of the educates training platform binary can be a hassle—especially when you need to switch between versions for different projects, test new releases, or roll back to a previous version. Manual downloads, renaming, and path management are error-prone and time-consuming.

Enter educatesenv, a simple CLI tool to install, switch, and manage multiple versions of the educates CLI, inspired by tools like tfenv and rbenv.