Small changes in documentation.

This commit is contained in:
2026-05-28 09:26:39 +02:00
parent 7435900497
commit 36b8b5de78
2 changed files with 27 additions and 24 deletions
+20 -21
View File
@@ -76,33 +76,32 @@ Use this prompt when asking ChatGPT to make a new Racket module or extend this
one: one:
```text ```text
Werk aan een Racket-module/package in een versievaste buildmap. Work on a Racket module/package in a version-locked buildmap.
Belangrijk: Important:
- Maak altijd een nieuwe submap voor de oplevering, bijvoorbeeld - Always create a new subdirectory for the release, for example
/mnt/data/<project>-build-NNN/<collection-name>. /mnt/data/<project>-build-NNN/<collection-name>.
- Werk niet direct in /mnt/data met losse bestanden met dezelfde naam; - Do not work directly in /mnt/data with individual files of the same name;
voorkom versieverwarring door alles in die buildmap te kopiëren/patchen. avoid version confusion by copying/patching everything into that buildmap.
- Houd de package-structuur stabiel: - Keep the package structure consistent:
- main.rkt voor de publieke module; - main.rkt for the public module;
- testing/ voor test-infrastructuur en regressietests; - testing/ for test infrastructure and regression tests;
- demo/ voor demonstratiebestanden; - demo/ for demonstration files;
- info.rkt voor package metadata en test entry points. - info.rkt for package metadata and test entry points.
- Pas require-paden aan op die structuur voordat je test. - Adjust require paths to match that structure before testing.
- Test met Racket zelf, bijvoorbeeld: - Test with Racket itself, for example:
/tmp/racket/bin/raco make <collection>/main.rkt <collection>/testing/<tests>.rkt /tmp/racket/bin/raco make <collection>/main.rkt <collection>/testing/<tests>.rkt
/tmp/racket/bin/racket <collection>/testing/<tests>.rkt /tmp/racket/bin/racket <collection>/testing/<tests>.rkt
- Als JavaScript nodig is, gebruik een aparte executor/test-framework module. - If JavaScript is required, use a separate executor/test-framework module.
Tests mogen niet falen alleen omdat node/deno/bun/qjs ontbreekt; ze moeten Tests must not fail simply because node/deno/bun/qjs is missing; they must
dan skippen met duidelijke warnings, tenzij een REQUIRE-envvar is gezet. skip with clear warnings unless a REQUIRE environment variable has been set.
- Gebruik geen shell-internet voor dependencies. Als packages nodig zijn, haal - Do not use shell-based internet access for dependencies. If packages are needed, retrieve
ze via de rktsndbx bootstrap/package-index flow op. them via the rktsndbx bootstrap/package-index flow.
- Lever na afloop een zip van exact de geteste buildmap op. - After completion, provide a zip file containing exactly the tested buildmap.
- Rapporteer kort welke commando's zijn uitgevoerd, wat de testresultaten waren, - Briefly report which commands were executed, what the test results were,
en welke zip het geteste resultaat bevat. and which zip file contains the tested result.
``` ```
## Latest tested fix ## Latest tested fix
This build includes the `with-handlers` callee-position fix for inline lambda This build includes the `with-handlers` callee-position fix for inline lambda
+7 -3
View File
@@ -20,9 +20,13 @@
@defmodule[js-maker] @defmodule[js-maker]
This module has been largely coded as an evolution to the @{js-transformer} setup This module has been largely coded as an evolution to the @tt{js-transformer} setup
from @racket{racket-webview} by supervising it's evolution using AI. from @tt{racket-webview} by supervising it's evolution using AI.
It is astonishing what AI can do these days. It is astonishing what AI can do these days. To get the AI agent this far
on racket and testing the output by itself, I had to get @tt{racket} installed
in the coding sandbox of the AI agent.
See @hyperlink["https://racket.discourse.group/t/a-small-experiment-bootstrapping-racket-into-a-chatgpt-sandbox-at-openai/4238"]{the discourse article}
about that.
@bold{js-maker} is a small, syntax-driven JavaScript generator for writing a @bold{js-maker} is a small, syntax-driven JavaScript generator for writing a
practical JavaScript subset in Racket notation. It provides two macros, practical JavaScript subset in Racket notation. It provides two macros,