Fix broken internal links.

Author: ntoll

docs/beginning-pyscript.md

@@ -332,7 +332,7 @@ the [user guide](user-guide/display.md).
 user interfaces from Python code - build forms, tables, and interactive
 components without writing HTML. You can compose complex layouts using familiar
 Python syntax. Explore the possibilities in the
-[DOM interaction guide](user-guide/dom.md#pyscriptweb).
+[DOM interaction guide](user-guide/dom.md).
 
 **Handle any browser event**: Beyond simple clicks, you can respond to
 keyboard input, mouse movements, form submissions, and more. PyScript makes it

docs/example-apps/overview.md

@@ -37,7 +37,7 @@ demonstrates basic PyScript concepts: writing Python in HTML, handling
 user input, and manipulating the DOM. This is the first example new
 users encounter.
 
-[Run the app](../pirate-translator) | 
+[Run the app](./pirate-translator/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/pirate-translator) |
 [Beginning PyScript](../beginning-pyscript.md)
 
@@ -49,7 +49,7 @@ for DOM manipulation. Shows how to create, modify, and remove elements
 using Pythonic patterns along with element access, creating
 elements with Python functions, event handlers, dynamic content updates.
 
-[Run the app](../task-board-web) | 
+[Run the app](./task-board-web/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/task-board-web) |
 [The DOM](../user-guide/dom.md)
 
@@ -60,7 +60,7 @@ where `pyscript.web` isn't sufficient along with direct JavaScript object
 access, `ffi.create_proxy` for event handlers, working with JavaScript
 APIs, when to use FFI vs `pyscript.web`.
 
-[Run the app](../task-board-ffi) | 
+[Run the app](./task-board-ffi/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/task-board-ffi) |
 [The DOM](../user-guide/dom.md) |
 [The FFI](../user-guide/ffi.md)
@@ -73,7 +73,7 @@ interactions and update the interface based on input. Specific use of
 event handlers via `pyscript.web`, handling multiple input types (sliders,
 text), real-time updates, colour manipulation.
 
-[Run the app](../colour-picker) | 
+[Run the app](./colour-picker/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/colour-picker) |
 [Events](../user-guide/events.md)
 
@@ -86,7 +86,7 @@ formatted tables, creating Matplotlib plots (single and subplots),
 incremental UI updates with `async`, appending vs replacing content. This
 is how to present data and visualisations in the browser with PyScript.
 
-[Run the app](../display-demo) | 
+[Run the app](./display-demo/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/display-demo) |
 [Display](../user-guide/display.md)
 
@@ -99,7 +99,7 @@ optional NumPy comparison. Specifically, this code shows how to use web
 workers for background computation, MicroPython vsPyodide performance,
 worker-main thread communication, and responsive UI during computation.
 
-[Run the app](../prime-worker) | 
+[Run the app](./prime-worker/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/prime-worker) |
 [Workers](../user-guide/workers.md)
 
@@ -116,7 +116,7 @@ reading and writing files, virtual filesystem concepts, mounting local
 filesystems, permissions and user approvals, data persistence via the local
 filesystem mounted to locations on the virtual filesystem.
 
-[Run the app](../note-taker) | 
+[Run the app](./note-taker/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/note-taker) |
 [Filesystems](../user-guide/filesystem.md)
 
@@ -127,7 +127,7 @@ media device access. Captures photos from the user's camera using the PyScript
 media API. Demonstrates camera access with `pyscript.media`, requesting user
 permissions, capturing still frames, canvas manipulation.
 
-[Run the app](../photobooth) | 
+[Run the app](./photobooth/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/photobooth) |
 [Media](../user-guide/media.md)
 
@@ -139,7 +139,7 @@ detection running entirely in the browser. This shows idiomatic PyGame-CE
 integration with PyScript, game loop with `await asyncio.sleep()`, loading
 assets, basic game physics.
 
-[Run the app](../bouncing-ball) | 
+[Run the app](./bouncing-ball/index.html) | 
 [View the code on GitHub](https://github.com/pyscript/docs/tree/main/docs/example-apps/bouncing-ball) |
 [PyGame Support](../user-guide/pygame-ce.md)
 
@@ -173,7 +173,7 @@ good example, consider contributing it. Good example applications:
 ## What's next
 
 After exploring these examples, consult the
-[PyScript user guide](../user-guide/) for comprehensive documentation on
+[PyScript user guide](../user-guide/index.md) for comprehensive documentation on
 all features. The guide provides deeper explanations of concepts
 demonstrated in these examples.
 

docs/example-apps/task-board-ffi/info.md

@@ -22,7 +22,7 @@ JavaScript API calls.
 ## Features
 
 This is the exact same application as the
-[pyscript.web version](../task-board-web/), but implemented using
+[pyscript.web version](../task-board-web/index.html), but implemented using
 JavaScript APIs directly. Key differences:
 
 ## Files

docs/example-apps/task-board-web/info.md

@@ -40,5 +40,5 @@ All DOM manipulation uses `pyscript.web`'s Pythonic interface:
 
 ## Compare with FFI version
 
-See the [FFI version](../task-board-ffi/) of this same application to
+See the [FFI version](../task-board-ffi/index.html) of this same application to
 compare the Pythonic approach with direct JavaScript API calls.

docs/faq.md

@@ -79,7 +79,7 @@ element.
 You've explicitly created a `PyWorker` or `MPWorker` instance somewhere
 in your code without providing a `service_worker` fallback.
 
-The [workers guide](../user-guide/workers/) documents all these cases
+The [workers guide](./user-guide/workers.md) documents all these cases
 with code examples and solutions.
 
 #### Why
@@ -105,7 +105,7 @@ responsive during heavy computation.
 
 Unfortunately, we cannot patch or work around these primitives - they're
 defined by web standards. However, various solutions exist for working
-within these limitations. The [workers guide](../user-guide/workers/)
+within these limitations. The [workers guide](./user-guide/workers.md)
 explains how.
 
 ### Borrowed proxy
@@ -160,7 +160,7 @@ it must not be garbage collected - hence the error.
 Two solutions exist:
 
 Manually wrap functions with
-[`pyscript.ffi.create_proxy`](../../api/#pyscriptfficreate_proxy):
+[`pyscript.ffi.create_proxy`](./api/ffi.md#pyscript.ffi.create_proxy):
 
 ```python
 from pyscript import ffi, window
@@ -173,7 +173,7 @@ window.setTimeout(
 ```
 
 Or set
-[`experimental_create_proxy = "auto"`](../configuration/#experimental_create_proxy)
+[`experimental_create_proxy = "auto"`](./user-guide/configuration.md#experimental_create_proxy)
 in your configuration. This intercepts Python objects passed to
 JavaScript callbacks and manages memory automatically via JavaScript's
 garbage collector.
@@ -208,7 +208,7 @@ configuration automates memory management via `FinalizationRegistry`.
 ### Python packages
 
 Sometimes Python packages specified via
-[`packages` configuration](../user-guide/configuration/#packages) don't
+[`packages` configuration](./user-guide/configuration.md#packages) don't
 work with PyScript's interpreters.
 
 !!! failure
@@ -248,7 +248,7 @@ to overcome this limitation.
 In MicroPython, the package hasn't been ported to the
 [`micropython-lib` repository](https://github.com/micropython/micropython-lib).
 To use pure Python packages with MicroPython, use the
-[files configuration](../user-guide/configuration/#files) to manually
+[files configuration](./user-guide/configuration.md#files) to manually
 copy the package onto the filesystem, or reference it via URL.
 
 The [packaging pointers](#packaging-pointers) section provides hints and
@@ -280,7 +280,7 @@ versions of `numpy` or `sqlite`).
 
 ### JavaScript modules
 
-When [using JavaScript modules](../user-guide/dom/#working-with-javascript)
+When [using JavaScript modules](./user-guide/dom.md#the-ffi-javascript-interoperability)
 you may encounter these errors:
 
 !!! failure
@@ -313,7 +313,7 @@ from pyscript.js_modules import d3
 
 Alternatively, ensure referenced JavaScript code uses `export` or
 request an `.mjs` version. The
-[user guide](../user-guide/dom/#working-with-javascript) covers all
+[user guide](./user-guide/dom.md#the-ffi-javascript-interoperability) covers all
 options and technical considerations for using JavaScript modules.
 
 #### Why

docs/user-guide/configuration.md

@@ -78,7 +78,7 @@ _single_ `<py-config>` or `<mpy-config>` tag in your HTML document:
     these tags on the page per interpreter**.
 
     Additionally, `<py-config>` only works for `py`/`mpy` type scripts and is not used
-    with [`py-game`](../pygame-ce) or [`py-editor`](../editor). For these use the config
+    with [`py-game`](./pygame-ce.md) or [`py-editor`](./editor.md). For these use the config
     attribute method.
 
 !!! warning
@@ -146,7 +146,7 @@ The `files` option fetches arbitrary content from URLs onto the virtual
 filesystem available to Python, and emulated by the browser. Just map a valid
 URL to a destination filesystem path on the in-browser virtual filesystem. You
 can find out more about the in-browser virtual filesystem in the section about
-[PyScript and filesystems](../filesystem/).
+[PyScript and filesystems](./filesystem.md).
 
 The following JSON and TOML are equivalent:
 
@@ -401,7 +401,7 @@ plugins = ["custom_plugin", "!error"]
 It's easy to import and use JavaScript modules in your Python code. This
 section of the docs examines the configuration needed to make this work. How
 to make use of JavaScript is dealt with
-[elsewhere](dom.md#working-with-javascript).
+[elsewhere](dom.md#working-with-javascript-libraries).
 
 We need to tell PyScript about the JavaScript modules you want to
 use. This is the purpose of the `js_modules` related configuration fields.
@@ -501,7 +501,7 @@ without the need for the worker to interact with the main thread. You're simply
 awaiting the result of a method exposed from a worker.
 
 This has the advantage of not requiring the use of `SharedArrayBuffer` and
-[associated CORS related header configuration](workers.md#http-headers).
+[associated CORS related header configuration](workers.md#understanding-the-problem).
 
 If the `sync_main_only` flag is set, then **interactions between the main thread
 and workers are limited to one way calls from the main thread to methods
@@ -532,7 +532,7 @@ If `sync_main_only` is set, the following caveats apply:
 
 Knowing when to use the `pyscript.ffi.create_proxy` method when using Pyodide
 can be confusing at the best of times and full of
-[technical "magic"](ffi.md#create_proxy).
+[technical "magic"](ffi.md#creating-function-proxies).
 
 This _experimental_ flag, when set to `"auto"` will cause PyScript to try to
 automatically handle such situations, and should "just work".

docs/user-guide/dom.md

@@ -312,7 +312,7 @@ dom_element = element._dom_element
 
     For complete API documentation of `pyscript.web`, including all
     available element types and methods, see the
-    [API reference](../../api/web).
+    [API reference](../api/web.md).
 
 ## Example: Task board with pyscript.web
 
@@ -409,14 +409,14 @@ PyScript signals and honours this difference.
 !!! info
 
     For more technical details about JavaScript class instantiation,
-    see the [FAQ](../../faq/#javascript-classnew).
+    see the [FAQ](../faq.md#javascript-classnew).
 
 ### Lower-level FFI features
 
 Advanced users who need lower-level access to FFI features can use
 functions in the `pyscript.ffi` namespace, available in both Pyodide
 and MicroPython. These functions are documented in the
-[API reference](../../api/ffi).
+[API reference](../api/ffi.md).
 
 For deep technical details about how the FFI works, see the
 [FFI technical guide](ffi.md).

docs/user-guide/what.md

@@ -1,7 +1,7 @@
 # What is PyScript?
 
 [PyScript](https://pyscript.net) is an
-[open source](../../license/) platform for running
+[open source](../license.md) platform for running
 [Python](https://python.org) in modern
 [web browsers](https://en.wikipedia.org/wiki/Web_browser).
 
@@ -94,7 +94,7 @@ Python. The FFI makes it seamless.
 Put simply, PyScript helps Python and JavaScript to be friends that
 complement and amplify each others strengths.
 
-Learn more about the FFI in the high level [DOM interaction guide](dom.md#ffi)
+Learn more about the FFI in the high level [DOM interaction guide](dom.md#the-ffi-javascript-interoperability)
 or dive deep into the [FFI's technical details](ffi.md).
 
 ## Key capabilities
@@ -168,9 +168,9 @@ Learn more in the [workers guide](workers.md).
 ### Device capabilities
 
 PyScript gives your Python code access to modern browser capabilities:
-capture photos and video with the [camera](media.md#camera), record
-[audio](media.md#audio), read and write [files](filesystem.md), store
-data [locally](storage.md), and integrate with all the other available
+capture photos and video with the [camera](media.md), record
+[media](media.md#capturing-media-streams), read and write [files](filesystem.md), store
+data [locally](../api/storage.md), and integrate with all the other available
 web APIs.
 
 Build applications that feel native, with access to device hardware and

docs/user-guide/workers.md

@@ -19,6 +19,22 @@ Workers solve this problem by running Python in separate threads. The main
 thread handles the UI. Workers handle computation. Both run simultaneously, so
 your application remains responsive even during heavy processing.
 
+!!! warning
+
+    For workers to work properly, your web server must send specific HTTP
+    headers:
+
+    ```
+    Access-Control-Allow-Origin: *
+    Cross-Origin-Opener-Policy: same-origin
+    Cross-Origin-Embedder-Policy: require-corp
+    Cross-Origin-Resource-Policy: cross-origin
+    ```
+
+    If you don't have control over your web server's headers, we recommend
+    you make use of the [mini-coi](https://github.com/WebReflection/mini-coi)
+    project (see their README for details).
+
 ## Defining workers
 
 Workers are defined with `<script>` tags that have a `worker` attribute: