summaryrefslogtreecommitdiffstats
path: root/docs/10-post-1.0/experimental-host-acceleration.md
diff options
context:
space:
mode:
authorArthur Hanson Rasmusson <arthur@vgpu.io>2026-10-02 00:39:56 -0400
committerArthur Hanson Rasmusson <arthur@vgpu.io>2026-10-02 00:39:56 -0400
commit7d0601397abdad813ca93ff9a2bd8cc5a2782879 (patch)
tree084d998c9d80e4e707ab5b9debe3abaf53ec0536 /docs/10-post-1.0/experimental-host-acceleration.md
parent2ccd9f875e53f8c9a98bfea47dc2657f3d3a1d6a (diff)
downloadopen-iov-7d0601397abdad813ca93ff9a2bd8cc5a2782879.tar.gz
open-iov-7d0601397abdad813ca93ff9a2bd8cc5a2782879.zip
docs: gate post-1.0 host acceleration as do-not-implement
Clarify in the post-1.0 record and the public status page that host-native acceleration / host display is a stretch goal we are only considering: do not block on it, pursue it, or design around it. It is never reached automatically, requires an explicit human decision after all baseline goals are complete (and only once there is no known risk), and may be scrapped on architectural grounds. No aspect of the baseline software may be designed toward it. No baseline design or code changes.
Diffstat (limited to 'docs/10-post-1.0/experimental-host-acceleration.md')
-rw-r--r--docs/10-post-1.0/experimental-host-acceleration.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/10-post-1.0/experimental-host-acceleration.md b/docs/10-post-1.0/experimental-host-acceleration.md
index c88bcaa..38b9774 100644
--- a/docs/10-post-1.0/experimental-host-acceleration.md
+++ b/docs/10-post-1.0/experimental-host-acceleration.md
@@ -13,6 +13,22 @@
> 2026-10-02 after independent adversarial, soundness, and VM-risk reviews
> falsified the first design. The review record is kept privately.
>
+> **How to treat this goal (from the owner, 2026-10-02).** We are *considering*
+> doing this; we may do this at some point. We will probably take a crack at it
+> because it is a great feature — but **do not block on this, do not pursue it,
+> and do not design around it.** It will be important to try at some point, but
+> primary objectives and the other stretch goals come first. Only when we are
+> certain there is no risk — which we are not certain of now — will we make a
+> **human decision** to proceed. This is **never pursued automatically**.
+> Consider it, until further notice, **deferred**.
+>
+> **Do-not-implement rule (binding).** Treat this document and the goal it
+> describes as **"Do not implement"** until after *all* design goals are
+> reached — and even then the goal may be scrapped on architectural grounds.
+> No aspect of the software may be designed toward a forward-looking goal that
+> would support this experimental feature: no new abstractions, hooks, seams,
+> parameters, or "just in case" code for it, anywhere in the baseline system.
+>
> **Experimental policy (binding when the time comes):** any host-acceleration
> work is experimental; it may only be built behind a compile-time flag and
> enabled by an explicit module-load flag; it must not alter, replace, or
@@ -387,3 +403,7 @@ Until then, this document is dormant.
* **Policy:** do not implement unless the user explicitly asks; when
implemented, it is experimental, compile-time gated, module-load gated,
duplicate-path, and reversible; the baseline system is never compromised.
+ The goal is **never pursued automatically** — it requires an explicit human
+ decision after every baseline goal is complete and we are certain there is no
+ risk — and it may be scrapped on architectural grounds. Until then, no aspect
+ of the baseline software may be designed toward it.