docs: sync README, CHANGELOG and docs with the current state

docs/DECISIONS.md

@@ -14,7 +14,7 @@ why, the options on the table, and the trigger that should reopen it.
 would have required either `golang.org/x/tools` or an in-house parser), the
 resolver reads the **GOOBJ data directly** from the target package's `.a`
 archive.  The `.a` file contains a `_go_.o` member whose GOOBJ s is the
-same one gasm writes — the parser reuses the same layout (`blkSymdef`,
+same one gasm writes; the parser reuses the same layout (`blkSymdef`,
 `blkNonpkgdef`, the string table), so no new dependency was needed.
 
 **How it works.**
@@ -23,7 +23,7 @@ same one gasm writes — the parser reuses the same layout (`blkSymdef`,
 2. `extractGOOBJ` reads the ar archive, finds the `_go_.o` member, skips
    the `"go object …\n!\n"` preamble and parses the GOOBJ header.
 3. `goobjFile.symbols()` walks `blkSymdef` and `blkNonpkgdef` in definition
-   order — the same order the linker uses — to build the symbol → index
+   order (the same order the linker uses) to build the symbol-to-index
    mapping.
 4. `resolveExternalSymbols` wires the resolved `{PkgIdx, SymIdx}` into the
    GOOBJ emission.