Merge pull request #220 from pyscript/2026-6-2

WebReflection · web-flow · commit 89a5f071c736 · 2026-06-30T11:48:18.000+02:00
Bump version to 2026.6.2
diff --git a/docs/beginning-pyscript.md b/docs/beginning-pyscript.md
@@ -118,8 +118,8 @@ module, and a `<link>` to some PyScript specific CSS, in the document's
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width,initial-scale=1" />
       <title>🦜 Polyglot - Piratical PyScript</title>
-      <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-      <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+      <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+      <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
   </head>
   <body>
 
@@ -165,8 +165,8 @@ In the end, our HTML should look like this:
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width,initial-scale=1" />
       <title>🦜 Polyglot - Piratical PyScript</title>
-      <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-      <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+      <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+      <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
   </head>
   <body>
     <h1>Polyglot 🦜 💬 🇬🇧 ➡️ 🏴‍☠️</h1>
@@ -308,7 +308,7 @@ To run PyScript offline, without the need of a CDN or internet connection, read
 the [offline guide](user-guide/offline.md) section of the user guide.
 
 We also provide an `offline.zip` file with
-[each release](https://pyscript.net/releases/2026.6.1/). This file contains
+[each release](https://pyscript.net/releases/2026.6.2/). This file contains
 everything you need for an offline version of PyScript: PyScript itself,
 versions of Pyodide and MicroPython, and an index.html page from which you
 could create your offline-first PyScript work.
diff --git a/docs/developers.md b/docs/developers.md
@@ -283,8 +283,132 @@ terminal will change to include the name of your conda environment indicating th
   in a separate repository:
   [https://github.com/pyscript/docs](https://github.com/pyscript/docs)
 
-* The documentation's `README` file contains instructions for setting up a
-  development environment and contributing.
+* The project's homepage ([pyscript.net](https://pyscript.net/)) contains links
+  and signposts for help and documentation. This is also found in a separate
+  repository:
+  [https://github.com/pyscript/pyscript.net](https://github.com/pyscript/pyscript.net)
+
+## Release PyScript
+
+This is the procedure for cutting a new release of PyScript. To follow it you
+need the correct permissions on GitHub (you're a PyScript core maintainer /
+admin).
+
+The steps below must be done in order. Each phase depends on the GitHub release
+created in the first phase already existing, so don't skip ahead.
+
+Throughout, the version number for a release uses
+[calver](https://calver.org/) in the form `YYYY.M.N` (year, month, and the
+release number within that month). For example, the first release in June 2026
+is `2026.6.1`. Wherever you see `2026.6.1` in the examples below, substitute the
+actual calver of the release you are cutting.
+
+### 1. Cut the GitHub release
+
+* Navigate to the [GitHub page for PyScript releases](https://github.com/pyscript/pyscript/releases).
+* Click the "Draft a new release" button, which will [take you here](https://github.com/pyscript/pyscript/releases/new),
+  where you can fill in the details of the new release of PyScript.
+    - Create a new tag. This should be the calver for the new release.
+    - Set the target to `main`.
+    - Set the release title to the calver for the new release (the same value
+      as the new tag).
+    - Write the release notes as a Markdown bulleted list of the changes, along
+      with references to the related pull requests and the GitHub usernames of
+      those who contributed.
+    - Set the release label to "Latest".
+* Once you're happy with the draft release, click the "Publish release" button.
+  At this point the [prepare-release.yml](https://github.com/pyscript/pyscript/blob/main/.github/workflows/prepare-release.yml)
+  and then the [publish-release.yml](https://github.com/pyscript/pyscript/blob/main/.github/workflows/publish-release.yml)
+  GitHub actions will run, to generate the assets needed for the release.
+  You'll be able to [observe this process here](https://github.com/pyscript/pyscript/actions).
+
+**Verify:** there should be two outcomes.
+
+1. A new latest release listed on GitHub, containing the description and
+   related assets. For example: [https://github.com/pyscript/pyscript/releases/tag/2026.6.1](https://github.com/pyscript/pyscript/releases/tag/2026.6.1).
+2. A page describing the release at `pyscript.net/releases/<CALVER>`. For
+   example: [https://pyscript.net/releases/2026.6.1/](https://pyscript.net/releases/2026.6.1/).
+
+You're not done yet. Now the release exists in GitHub, further changes to
+related repositories need to be made.
+
+### 2. Update the docs
+
+Each release of PyScript has its own version of the docs. The generation of the
+docs is handled automatically by GitHub actions. Inside the
+[documentation repository](https://github.com/pyscript/docs), the process is:
+
+* Create a new branch whose name is that of the new calver release (but use `-`
+  instead of `.` between the numbers, e.g. `2026-6-1`).
+* Update the [`version.json`](https://github.com/pyscript/docs/blob/main/version.json)
+  file to the new calver.
+* Run `node version-update.js`. This will automatically update all the
+  references to the old calver to the new calver. It also downloads the new
+  version's Python API and auto-builds the API docs.
+* If you have outstanding PRs for updates to the documentation, merge or resolve
+  them into this branch at this moment in time.
+* Once you're happy with the state of the documentation for this new version,
+  create a PR for your branch in GitHub.
+* Once the PR is approved and merged, a GitHub action based on
+  [`update_docs.yml`](https://github.com/pyscript/docs/blob/main/.github/workflows/update_docs.yml)
+  will run to generate the new version of the documentation in the `gh-pages`
+  branch.
+
+**Verify:** once the `gh-pages` branch is updated, GitHub's own automatic
+deployment action will kick in, making the new version of the documentation
+live. You'll be able to [observe this process here](https://github.com/pyscript/docs/actions).
+Check the updated docs at
+[docs.pyscript.net](https://docs.pyscript.net) (and remember to clear your
+browser cache).
+
+### 3. Update the homepage
+
+Update two files in the
+[homepage repository](https://github.com/pyscript/pyscript.net) to use the
+latest calver:
+
+1. In [`index.html`](https://github.com/pyscript/pyscript.net/blob/main/index.html),
+   update ALL references to the old calver with the new version's calver. This
+   includes the `<link>` and `<script>` tags in the `<head>` of the document,
+   along with the content of the `<span class="subhead">` tag in the `<header>`
+   tag in the `<body>` of the document.
+2. Update the [`version.json`](https://github.com/pyscript/pyscript.net/blob/main/version.json)
+   file to a JSON string containing the new calver.
+
+Bundle these changes into a single PRi (named in the same way as the PR for
+PyScript's docs), to be reviewed and approved by someone
+else.
+[This pull request](https://github.com/pyscript/pyscript.net/pull/104/changes)
+is a good historical example of the changes described above.
+
+**Verify**: Once your PR is reviewed and merged GitHub automatically deploys
+the changes.
+[Observe this process here](https://github.com/pyscript/pyscript.net/actions).
+Once deployed, check your changes at [pyscript.net](https://pyscript.net)
+(you may need to clear your browser cache).
+
+### 4. Update the README
+
+Update the opening HTML example in
+[PyScript's README](https://github.com/pyscript/pyscript/blob/main/README.md)
+to reference the new latest version.
+
+### 5. Announce the release
+
+**Verify first:** visit the new release's page on pyscript.net (for example,
+[https://pyscript.net/releases/2026.6.1/](https://pyscript.net/releases/2026.6.1/))
+and ensure the "Home", "Docs", "Code" and "Changes" links all point to the
+pages and assets you've just updated.
+
+Now all the pieces are in place, visit the
+[`#announcements`](https://discord.com/channels/972017612454232116/1028271951082442832)
+channel on the PyScript Discord server, and post a message along the lines of:
+
+> @here we have a new release of PyScript! All the details can be found here:
+> https://pyscript.net/releases/2026.6.1/ As always, feedback welcome. 🎉
+
+Remember to substitute the actual new calver, not the `2026.6.1` used in these
+examples.
 
 ## Contributing
 
diff --git a/docs/example-apps/bouncing-ball/index.html b/docs/example-apps/bouncing-ball/index.html
@@ -4,8 +4,8 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1.0">
     <title>PyGame-CE Bouncing Ball</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, sans-serif;
diff --git a/docs/example-apps/colour-picker/index.html b/docs/example-apps/colour-picker/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Interactive Colour Picker</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, -apple-system, sans-serif;
diff --git a/docs/example-apps/display-demo/index.html b/docs/example-apps/display-demo/index.html
@@ -5,9 +5,9 @@
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Display Demo</title>
     <link rel="stylesheet" 
-      href="https://pyscript.net/releases/2026.6.1/core.css">
+      href="https://pyscript.net/releases/2026.6.2/core.css">
     <script type="module" 
-      src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+      src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, -apple-system, sans-serif;
diff --git a/docs/example-apps/note-taker/index.html b/docs/example-apps/note-taker/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Note Taker</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, sans-serif;
diff --git a/docs/example-apps/photobooth/index.html b/docs/example-apps/photobooth/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Photobooth</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, sans-serif;
diff --git a/docs/example-apps/pirate-translator/index.html b/docs/example-apps/pirate-translator/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>🦜 Polyglot - Piratical PyScript</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
   </head>
   <body>
     <h1>Polyglot 🦜 💬 🇬🇧 ➡️ 🏴‍☠️</h1>
diff --git a/docs/example-apps/prime-worker/index.html b/docs/example-apps/prime-worker/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Prime Numbers with Workers</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, sans-serif;
diff --git a/docs/example-apps/task-board-ffi/index.html b/docs/example-apps/task-board-ffi/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Task Board - FFI</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, -apple-system, sans-serif;
diff --git a/docs/example-apps/task-board-web/index.html b/docs/example-apps/task-board-web/index.html
@@ -4,8 +4,8 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Task Board - pyscript.web</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
     <style>
       body {
         font-family: system-ui, -apple-system, sans-serif;
diff --git a/docs/faq.md b/docs/faq.md
@@ -541,7 +541,7 @@ versions or use `latest`:
 
 ```html
 <!-- Specific version (recommended for production). -->
-<script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+<script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
 
 <!-- Latest version (useful for development). -->
 <script type="module" src="https://pyscript.net/latest/core.js"></script>
@@ -572,7 +572,7 @@ You can create workers programmatically from JavaScript:
 
 ```html
 <script type="module">
-import { PyWorker } from "https://pyscript.net/releases/2026.6.1/core.js";
+import { PyWorker } from "https://pyscript.net/releases/2026.6.2/core.js";
 
 const worker = new PyWorker("./worker.py", {type: "pyodide"});
 
diff --git a/docs/index.md b/docs/index.md
@@ -6,8 +6,8 @@
 **Step 1:** Add these two lines to the `<head>` of your HTML document:
 
 ```html
-<link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css" />
-<script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+<link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css" />
+<script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
 ```
 
 **Step 2:** Start PyScript with a `<script>` tag in the `<body>` of your HTML document:
diff --git a/docs/user-guide/configuration.md b/docs/user-guide/configuration.md
@@ -672,8 +672,8 @@ Here's a complete example showing common configuration options:
   <head>
     <meta charset="utf-8" />
     <title>My PyScript App</title>
-    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.1/core.css">
-    <script type="module" src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    <link rel="stylesheet" href="https://pyscript.net/releases/2026.6.2/core.css">
+    <script type="module" src="https://pyscript.net/releases/2026.6.2/core.js"></script>
   </head>
   <body>
     <h1>Data Analysis</h1>
diff --git a/docs/user-guide/from_javascript.md b/docs/user-guide/from_javascript.md
@@ -41,7 +41,7 @@ serialised to formats JavaScript can understand.
 JavaScript code imports the storage module from PyScript core:
 
 ```javascript title="Access storage in JavaScript."
-import storage from 'https://pyscript.net/releases/2026.6.1/storage.js';
+import storage from 'https://pyscript.net/releases/2026.6.2/storage.js';
 
 
 const my_store = await storage(name="shared");
@@ -81,7 +81,7 @@ use Python from pure JavaScript without writing PyScript tags.
 Import the `donkey` function and create a worker with it:
 
 ```javascript title="Call for the PyScript donkey."
-import { donkey } from 'https://pyscript.net/releases/2026.6.1/core.js';
+import { donkey } from 'https://pyscript.net/releases/2026.6.2/core.js';
 
 const py_donkey = await donkey({
   type: 'mpy',        // Use MicroPython ('py' for Pyodide).
diff --git a/docs/user-guide/offline.md b/docs/user-guide/offline.md
@@ -30,7 +30,7 @@ libraries, the package files must also be available offline.
 ## Shortcut
 
 Helpfully, since the end of 2025, all
-[releases of PyScript](https://pyscript.net/releases/2026.6.1/)
+[releases of PyScript](https://pyscript.net/releases/2026.6.2/)
 have an associated `offline`
 zip file containing everything you need. Just download it, unpack it and
 start to modify the content of the `index.html` found therein to your needs.
diff --git a/docs/user-guide/plugins.md b/docs/user-guide/plugins.md
@@ -113,7 +113,7 @@ references fail.
 This works because everything is self-contained:
 
 ```js title="Everything is in the scope of the inner function."
-import { hooks } from "https://pyscript.net/releases/2026.6.1/core.js";
+import { hooks } from "https://pyscript.net/releases/2026.6.2/core.js";
 
 hooks.worker.onReady.add(() => {
     // Define global variable if it doesn't exist.
@@ -126,7 +126,7 @@ hooks.worker.onReady.add(() => {
 This fails because of the outer scope reference:
 
 ```js title="Failure because the inner function won't have access to 'i'."
-import { hooks } from "https://pyscript.net/releases/2026.6.1/core.js";
+import { hooks } from "https://pyscript.net/releases/2026.6.2/core.js";
 
 // This won't work in workers!
 let i = 0;
@@ -150,7 +150,7 @@ Here's a complete plugin that logs lifecycle events to the console:
 
 ```js title="A contrived example plugin."
 // Import hooks from PyScript.
-import { hooks } from "https://pyscript.net/releases/2026.6.1/core.js";
+import { hooks } from "https://pyscript.net/releases/2026.6.2/core.js";
 
 // Register main thread hooks.
 hooks.main.onReady.add((wrap, element) => {
@@ -207,9 +207,9 @@ Include this plugin before PyScript:
     
     <!-- PyScript loads after. -->
     <link rel="stylesheet" 
-      href="https://pyscript.net/releases/2026.6.1/core.css">
+      href="https://pyscript.net/releases/2026.6.2/core.css">
     <script type="module" 
-      src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+      src="https://pyscript.net/releases/2026.6.2/core.js"></script>
 </head>
 <body>
     <script type="mpy">
diff --git a/docs/user-guide/pygame-ce.md b/docs/user-guide/pygame-ce.md
@@ -113,9 +113,9 @@ The HTML file needs a canvas element and the script tag:
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1.0">
   <link rel="stylesheet" 
-    href="https://pyscript.net/releases/2026.6.1/core.css">
+    href="https://pyscript.net/releases/2026.6.2/core.css">
   <script type="module" 
-    src="https://pyscript.net/releases/2026.6.1/core.js"></script>
+    src="https://pyscript.net/releases/2026.6.2/core.js"></script>
 </head>
 <body>
   <canvas id="canvas" style="image-rendering: pixelated"></canvas>
diff --git a/version.json b/version.json
@@ -1,3 +1,3 @@
 {
-    "version": "2026.6.1"
+    "version": "2026.6.2"
 }
